Function finish

engine/src/cli.ts:305–316

(err?: Error)

): Promise<{ kildId?: string; handle?: string }> {
  if (id && handle) return { kildId: id, handle };
  const session = harnessSession();
  // Deliberately NOT guarded. An unreadable record means "there may be an attachment and I
  // cannot read it", and a `kild send` that swallowed that would post the message with no
  // credential — silently unattributed, which is the exact bug this file exists to fix. The
  // one caller allowed to degrade to silence is the turn-end hook, and it does so at its own
  // call site where it knows it is a hook.
  const record = session ? await findAttachment(session) : null;
  return {
    kildId: id ?? record?.kildId ?? process.env.KILD_KILD_ID ?? undefined,
    handle: handle ?? record?.handle ?? process.env.KILD_HANDLE ?? undefined,
  };
}

/** `kild attach <id> --as <handle>` — register an ATTACHED agent: a harness kild
 *  does not own (the Claude Code session you are driving) claiming a `@handle` in the