Add adapter session codecs with cwd-aware resume and unknown-session retry

Introduce AdapterSessionCodec interface for structured session serialization,
deserialization, and display ID extraction. Implement codecs for claude_local
and codex_local adapters with cwd validation — sessions saved for a different
working directory are not resumed. Both adapters now return sessionParams and
sessionDisplayId alongside legacy sessionId.

Add isCodexUnknownSessionError detection and automatic retry with fresh session
for codex_local (matching existing claude_local behavior). Inject approval
context env vars (PAPERCLIP_APPROVAL_ID, PAPERCLIP_APPROVAL_STATUS,
PAPERCLIP_LINKED_ISSUE_IDS) into adapter environments.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

packages/adapter-utils/src/index.ts

@@ -5,6 +5,7 @@ export type {
   AdapterExecutionResult,
   AdapterInvocationMeta,
   AdapterExecutionContext,
+  AdapterSessionCodec,
   ServerAdapterModule,
   TranscriptEntry,
   StdoutLineParser,

packages/adapter-utils/src/types.ts

@@ -11,7 +11,13 @@ export interface AdapterAgent {
 }
 
 export interface AdapterRuntime {
+  /**
+   * Legacy single session id view. Prefer `sessionParams` + `sessionDisplayId`.
+   */
   sessionId: string | null;
+  sessionParams: Record<string, unknown> | null;
+  sessionDisplayId: string | null;
+  taskKey: string | null;
 }
 
 // ---------------------------------------------------------------------------
@@ -30,7 +36,12 @@ export interface AdapterExecutionResult {
   timedOut: boolean;
   errorMessage?: string | null;
   usage?: UsageSummary;
+  /**
+   * Legacy single session id output. Prefer `sessionParams` + `sessionDisplayId`.
+   */
   sessionId?: string | null;
+  sessionParams?: Record<string, unknown> | null;
+  sessionDisplayId?: string | null;
   provider?: string | null;
   model?: string | null;
   costUsd?: number | null;
@@ -39,6 +50,12 @@ export interface AdapterExecutionResult {
   clearSession?: boolean;
 }
 
+export interface AdapterSessionCodec {
+  deserialize(raw: unknown): Record<string, unknown> | null;
+  serialize(params: Record<string, unknown> | null): Record<string, unknown> | null;
+  getDisplayId?: (params: Record<string, unknown> | null) => string | null;
+}
+
 export interface AdapterInvocationMeta {
   adapterType: string;
   command: string;
@@ -63,6 +80,7 @@ export interface AdapterExecutionContext {
 export interface ServerAdapterModule {
   type: string;
   execute(ctx: AdapterExecutionContext): Promise<AdapterExecutionResult>;
+  sessionCodec?: AdapterSessionCodec;
   supportsLocalAgentJwt?: boolean;
   models?: { id: string; label: string }[];
   agentConfigurationDoc?: string;