pilotswarm-sdk 0.1.3

package/dist/managed-session.d.ts

@@ -0,0 +1,70 @@
+import { type Tool, type CopilotSession } from "@github/copilot-sdk";
+import type { TurnResult, TurnOptions, ManagedSessionConfig } from "./types.js";
+/**
+ * ManagedSession — wraps a CopilotSession and provides the interface
+ * that the orchestration calls into (via SessionProxy).
+ *
+ * Key design decisions:
+ *  1. Uses send() + on() internally, never sendAndWait().
+ *  2. runTurn() returns a TurnResult to the orchestration — the orchestration
+ *     decides what to do with wait/input_required/completed.
+ *  3. The session stays alive in memory across runTurn() calls.
+ *  4. Abort is cooperative — the orchestration cancels via race, which
+ *     triggers abort() on this session.
+ *
+ * @internal
+ */
+export declare class ManagedSession {
+    readonly sessionId: string;
+    private copilotSession;
+    private config;
+    constructor(sessionId: string, copilotSession: CopilotSession, config: ManagedSessionConfig);
+    /**
+     * System tool definitions for session creation.
+     * These are registered at createSession time so the LLM sees them.
+     * Handlers are placeholder stubs — real handlers are set per-turn in runTurn().
+     */
+    static systemToolDefs(): Tool<any>[];
+    /**
+     * Sub-agent tool definitions.
+     * These are the LLM-visible tools for spawning and managing sub-agents.
+     * Like wait/ask_user, handlers are stubs — real handlers set per-turn in runTurn().
+     */
+    static subAgentToolDefs(): Tool<any>[];
+    /**
+     * Child management tool definitions (complete, cancel, delete).
+     * Separated for clarity but included in subAgentToolDefs().
+     */
+    static _childManagementToolDefs(): Tool<any>[];
+    /**
+     * Run one LLM turn.
+     *
+     * The wait tool is injected automatically. If the LLM calls wait()
+     * with seconds > waitThreshold, we abort the session and return
+     * a "wait" result so the orchestration can schedule a durable timer.
+     *
+     * Similarly, if onUserInputRequest fires, we abort and return
+     * "input_required" so the orchestration can wait for the user's answer.
+     */
+    runTurn(prompt: string, opts?: TurnOptions): Promise<TurnResult>;
+    /**
+     * Abort the current in-flight message.
+     * Session remains alive for future runTurn() calls.
+     */
+    abort(): void;
+    /**
+     * Destroy the session — release resources, flush to disk.
+     */
+    destroy(): Promise<void>;
+    /**
+     * Get conversation messages from the underlying session.
+     */
+    getMessages(): Promise<unknown[]>;
+    /**
+     * Update configuration for the next turn.
+     */
+    updateConfig(config: Partial<ManagedSessionConfig>): void;
+    /** Get the underlying CopilotSession (for direct access when needed). */
+    getCopilotSession(): CopilotSession;
+}
+//# sourceMappingURL=managed-session.d.ts.map

package/dist/managed-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-session.d.ts","sourceRoot":"","sources":["../src/managed-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,IAAI,EAAE,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,KAAK,EAAc,UAAU,EAAE,WAAW,EAAE,oBAAoB,EAAiB,MAAM,YAAY,CAAC;AAY3G;;;;;;;;;;;;;GAaG;AACH,qBAAa,cAAc;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,MAAM,CAAuB;gBAGjC,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,cAAc,EAC9B,MAAM,EAAE,oBAAoB;IAOhC;;;;OAIG;IACH,MAAM,CAAC,cAAc,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE;IA8DpC;;;;OAIG;IACH,MAAM,CAAC,gBAAgB,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE;IAyGtC;;;OAGG;IACH,MAAM,CAAC,wBAAwB,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE;IAqD9C;;;;;;;;;OASG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAqdtE;;;OAGG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAIvC;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI;IAOzD,yEAAyE;IACzE,iBAAiB,IAAI,cAAc;CAGtC"}