@inixiative/agent-session 0.6.1 → 0.6.3

package/src/index.ts

@@ -17,6 +17,7 @@ export {
   type ClaudeCodeSessionConfig,
 } from './claude-code-session';
 export { type ClaudePrimedConfig, ClaudePrimedSessions } from './claude-primed';
+export { type ClaudeSubagentConfig, ClaudeSubagentSessions } from './claude-subagents';
 export { parseClaudeUsage } from './claude-usage';
 export {
   CODEX_DECISION_DISABLED_FEATURES,

package/src/primed.ts

@@ -46,6 +46,13 @@ export interface DecisionRequest {
   readonly outputSchema?: Readonly<Record<string, unknown>>;
   /** Cancel: refused before dispatch, or the running turn is interrupted and settled. */
   readonly signal?: AbortSignal;
+  /** Decisions of one group share a side session (ClaudeSubagentSessions): a Foundry thread. */
+  readonly group?: string;
+  /**
+   * The group's current context, which precedes `input` (ClaudeSubagentSessions): a member
+   * pre-started with exactly this context receives only `input`; otherwise both are sent.
+   */
+  readonly standby?: string;
 }
 
 export interface DecisionResult {
@@ -121,6 +128,15 @@ export type PrimedEvent =
       readonly cacheRead?: number;
       readonly input?: number;
     }
+  | {
+      /** A pre-started member's standby turn, until its moment (or its end): what pre-starting costs. */
+      readonly type: 'standby';
+      readonly key: string;
+      readonly input: number;
+      readonly output: number;
+      readonly cacheRead: number;
+      readonly cacheWrite: number;
+    }
   | { readonly type: 'limits'; readonly limits: LimitSnapshot }
   | { readonly type: 'violation'; readonly key: string; readonly detail: string }
   | { readonly type: 'hedged'; readonly key: string; readonly afterMs: number }
@@ -142,6 +158,10 @@ export interface PrimedSessions {
   decide(spec: PrimeSpec, request: DecisionRequest): Promise<DecisionResult>;
   /** Drop a key's primed session; the next decision re-primes it. */
   evict(key: string): Promise<void>;
+  /** Keep these roles of a group pre-started, holding this standby context (ClaudeSubagentSessions). */
+  prestart?(group: string, entries: ReadonlyArray<{ spec: PrimeSpec; standby: string }>): void;
+  /** A group is done (its thread closed): stop what it holds (ClaudeSubagentSessions). */
+  releaseGroup?(group: string): Promise<void>;
   limits(): LimitSnapshot | undefined;
   snapshot(): PrimedSnapshot;
   close(): Promise<void>;