pilotswarm-sdk 0.1.3

package/dist/blob-store.js

@@ -0,0 +1,220 @@
+import { BlobServiceClient, StorageSharedKeyCredential, generateBlobSASQueryParameters, BlobSASPermissions, SASProtocol, } from "@azure/storage-blob";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { DEFAULT_SESSION_STATE_DIR, archiveSessionDir, buildMetadata, extractSessionArchive, } from "./session-store.js";
+/**
+ * Manages session state in Azure Blob Storage.
+ *
+ * - `dehydrate()` — tar + upload session dir, remove local files
+ * - `hydrate()` — download + untar session dir
+ * - `checkpoint()` — tar + upload without removing local files
+ * - `exists()` / `delete()` — blob lifecycle
+ *
+ * @internal
+ */
+export class SessionBlobStore {
+    containerClient;
+    connectionString;
+    containerName;
+    credential = null;
+    sessionStateDir;
+    constructor(connectionString, containerName = "copilot-sessions", sessionStateDir) {
+        this.connectionString = connectionString;
+        this.containerName = containerName;
+        this.sessionStateDir = sessionStateDir ?? DEFAULT_SESSION_STATE_DIR;
+        const blobService = BlobServiceClient.fromConnectionString(connectionString);
+        this.containerClient = blobService.getContainerClient(containerName);
+        // Parse account name + key from connection string for SAS generation
+        const accountMatch = connectionString.match(/AccountName=([^;]+)/i);
+        const keyMatch = connectionString.match(/AccountKey=([^;]+)/i);
+        if (accountMatch && keyMatch) {
+            this.credential = new StorageSharedKeyCredential(accountMatch[1], keyMatch[1]);
+        }
+    }
+    /**
+     * Dehydrate a session: tar, upload, remove local files.
+     * Frees the worker slot for another session.
+     */
+    async dehydrate(sessionId, meta) {
+        const sessionDir = path.join(this.sessionStateDir, sessionId);
+        if (!fs.existsSync(sessionDir))
+            return;
+        const tarPath = path.join(os.tmpdir(), `${sessionId}.tar.gz`);
+        try {
+            archiveSessionDir(this.sessionStateDir, sessionId, tarPath);
+            // Upload tar
+            const tarBlob = this.containerClient.getBlockBlobClient(`${sessionId}.tar.gz`);
+            await tarBlob.uploadFile(tarPath);
+            // Upload metadata
+            const metadata = buildMetadata(tarPath, sessionId, meta);
+            const metaBlob = this.containerClient.getBlockBlobClient(`${sessionId}.meta.json`);
+            const metaJson = JSON.stringify(metadata);
+            await metaBlob.upload(metaJson, metaJson.length);
+            // Remove local files
+            fs.rmSync(sessionDir, { recursive: true, force: true });
+        }
+        finally {
+            // Always clean up temp tar
+            try {
+                fs.unlinkSync(tarPath);
+            }
+            catch { }
+        }
+    }
+    /**
+     * Hydrate a session: download tar from blob, extract to local disk.
+     * No-op if local session files already exist.
+     */
+    async hydrate(sessionId) {
+        const sessionDir = path.join(this.sessionStateDir, sessionId);
+        // Always download from blob — overwrite any stale local files
+        if (fs.existsSync(sessionDir)) {
+            fs.rmSync(sessionDir, { recursive: true, force: true });
+        }
+        const tarBlob = this.containerClient.getBlockBlobClient(`${sessionId}.tar.gz`);
+        const tarPath = path.join(os.tmpdir(), `${sessionId}.tar.gz`);
+        try {
+            await tarBlob.downloadToFile(tarPath);
+            extractSessionArchive(this.sessionStateDir, tarPath);
+        }
+        finally {
+            try {
+                fs.unlinkSync(tarPath);
+            }
+            catch { }
+        }
+    }
+    /**
+     * Checkpoint: upload current session state to blob without removing local files.
+     * Used for crash resilience — the session stays warm in memory.
+     */
+    async checkpoint(sessionId) {
+        const sessionDir = path.join(this.sessionStateDir, sessionId);
+        if (!fs.existsSync(sessionDir))
+            return;
+        const tarPath = path.join(os.tmpdir(), `${sessionId}.tar.gz`);
+        try {
+            archiveSessionDir(this.sessionStateDir, sessionId, tarPath);
+            const tarBlob = this.containerClient.getBlockBlobClient(`${sessionId}.tar.gz`);
+            await tarBlob.uploadFile(tarPath);
+            // Update metadata to reflect checkpoint (not full dehydration)
+            const metadata = buildMetadata(tarPath, sessionId, { reason: "checkpoint" });
+            const metaBlob = this.containerClient.getBlockBlobClient(`${sessionId}.meta.json`);
+            const metaJson = JSON.stringify(metadata);
+            await metaBlob.upload(metaJson, metaJson.length);
+        }
+        finally {
+            try {
+                fs.unlinkSync(tarPath);
+            }
+            catch { }
+        }
+    }
+    /** Check if a dehydrated session exists in blob storage. */
+    async exists(sessionId) {
+        const tarBlob = this.containerClient.getBlockBlobClient(`${sessionId}.tar.gz`);
+        return tarBlob.exists();
+    }
+    /** Delete a dehydrated session from blob storage. */
+    async delete(sessionId) {
+        await this.containerClient.getBlockBlobClient(`${sessionId}.tar.gz`).deleteIfExists();
+        await this.containerClient.getBlockBlobClient(`${sessionId}.meta.json`).deleteIfExists();
+    }
+    // ─── Artifact Storage ────────────────────────────────────
+    artifactBlobPath(sessionId, filename) {
+        // Sanitize filename — strip path separators
+        const safe = filename.replace(/[/\\]/g, "_");
+        return `artifacts/${sessionId}/${safe}`;
+    }
+    /**
+     * Upload an artifact file (e.g. .md) to blob storage.
+     * Max 1MB content.
+     */
+    async uploadArtifact(sessionId, filename, content, contentType = "text/markdown") {
+        const MAX_SIZE = 1_048_576; // 1MB
+        if (content.length > MAX_SIZE) {
+            throw new Error(`Artifact too large: ${content.length} bytes (max ${MAX_SIZE})`);
+        }
+        const blobPath = this.artifactBlobPath(sessionId, filename);
+        const blob = this.containerClient.getBlockBlobClient(blobPath);
+        await blob.upload(content, content.length, {
+            blobHTTPHeaders: { blobContentType: contentType },
+        });
+        return blobPath;
+    }
+    /**
+     * Download an artifact file from blob storage.
+     * Returns the file content as a string.
+     */
+    async downloadArtifact(sessionId, filename) {
+        const blobPath = this.artifactBlobPath(sessionId, filename);
+        const blob = this.containerClient.getBlockBlobClient(blobPath);
+        const response = await blob.download(0);
+        const chunks = [];
+        for await (const chunk of response.readableStreamBody) {
+            chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+        }
+        return Buffer.concat(chunks).toString("utf-8");
+    }
+    /**
+     * List artifact files for a session.
+     * Returns filenames (not full blob paths).
+     */
+    async listArtifacts(sessionId) {
+        const prefix = `artifacts/${sessionId}/`;
+        const files = [];
+        for await (const blob of this.containerClient.listBlobsFlat({ prefix })) {
+            // Strip the prefix to get just the filename
+            files.push(blob.name.slice(prefix.length));
+        }
+        return files;
+    }
+    /**
+     * Check if an artifact exists.
+     */
+    async artifactExists(sessionId, filename) {
+        const blobPath = this.artifactBlobPath(sessionId, filename);
+        return this.containerClient.getBlockBlobClient(blobPath).exists();
+    }
+    /**
+     * Generate a short-lived read-only SAS URL for an artifact.
+     * The TUI uses this to download files without needing blob credentials.
+     *
+     * @param sessionId  Session that owns the artifact
+     * @param filename   Artifact filename
+     * @param expiryMinutes  How long the URL is valid (default: 1 minute)
+     * @returns Full SAS URL string
+     */
+    generateArtifactSasUrl(sessionId, filename, expiryMinutes = 1) {
+        if (!this.credential) {
+            throw new Error("Cannot generate SAS URL: connection string has no AccountKey");
+        }
+        const blobPath = this.artifactBlobPath(sessionId, filename);
+        const now = new Date();
+        const expiresOn = new Date(now.getTime() + expiryMinutes * 60_000);
+        const sas = generateBlobSASQueryParameters({
+            containerName: this.containerName,
+            blobName: blobPath,
+            permissions: BlobSASPermissions.parse("r"),
+            startsOn: now,
+            expiresOn,
+            protocol: SASProtocol.Https,
+        }, this.credential);
+        const blob = this.containerClient.getBlockBlobClient(blobPath);
+        return `${blob.url}?${sas.toString()}`;
+    }
+    /**
+     * Delete all artifacts for a session.
+     */
+    async deleteArtifacts(sessionId) {
+        const prefix = `artifacts/${sessionId}/`;
+        let count = 0;
+        for await (const blob of this.containerClient.listBlobsFlat({ prefix })) {
+            await this.containerClient.getBlockBlobClient(blob.name).deleteIfExists();
+            count++;
+        }
+        return count;
+    }
+}
+//# sourceMappingURL=blob-store.js.map

package/dist/blob-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blob-store.js","sourceRoot":"","sources":["../src/blob-store.ts"],"names":[],"mappings":"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"}

package/dist/client.d.ts

@@ -0,0 +1,159 @@
+import type { PilotSwarmClientOptions, ManagedSessionConfig, PilotSwarmSessionInfo, UserInputHandler } from "./types.js";
+import type { SessionCatalogProvider, SessionEvent } from "./cms.js";
+/**
+ * PilotSwarmClient — pure client-side session handle.
+ *
+ * Talks to duroxide only through the Client API (startOrchestration,
+ * enqueueEvent, waitForStatusChange, getStatus). Does NOT own
+ * SessionManager, Runtime, or CopilotSession.
+ *
+ * Creates its own duroxide Client and CMS catalog from the store URL.
+ * Completely independent of PilotSwarmWorker.
+ */
+export declare class PilotSwarmClient {
+    private config;
+    private _catalog;
+    private duroxideClient;
+    private sessionConfigs;
+    /** parentSessionId for sub-agent sessions. */
+    private parentSessionIds;
+    /** nestingLevel for sub-agent sessions. */
+    private nestingLevels;
+    /** System session flag. */
+    systemSessions: Set<string>;
+    private activeOrchestrations;
+    private lastSeenStatusVersion;
+    private lastSeenIteration;
+    private lastSeenResponseVersion;
+    private started;
+    /** Tracks agentId bound to each session (for policy and title prefixing). */
+    private sessionAgentIds;
+    /** Effective session policy (set via config from worker). */
+    private get _sessionPolicy();
+    /** Allowed agent names (set via config from worker). */
+    private get _allowedAgentNames();
+    constructor(options: PilotSwarmClientOptions);
+    createSession(config?: ManagedSessionConfig & {
+        sessionId?: string;
+        onUserInputRequest?: UserInputHandler;
+        /** Names of tools registered on the worker via worker.registerTools(). */
+        toolNames?: string[];
+        /** If this session is a sub-agent, the parent session ID. */
+        parentSessionId?: string;
+        /** Nesting level for sub-agent depth tracking. */
+        nestingLevel?: number;
+        /** Agent ID to bind this session to (for policy validation and title prefixing). */
+        agentId?: string;
+    }): Promise<PilotSwarmSession>;
+    /**
+     * Create a session bound to a named agent.
+     *
+     * Validates that the agent exists in the loaded (non-system) agent list.
+     * Sets the agentId on the session and applies a prefixed title:
+     * `"Agent Title: <shortId>"`.
+     *
+     * @throws If the agent is not found, is a system agent, or policy rejects it.
+     */
+    createSessionForAgent(agentName: string, opts?: {
+        model?: string;
+        onUserInputRequest?: UserInputHandler;
+        toolNames?: string[];
+        title?: string;
+        splash?: string;
+        initialPrompt?: string;
+    }): Promise<PilotSwarmSession>;
+    /**
+     * Create a system session (e.g. Sweeper Agent).
+     *
+     * System sessions are protected from deletion and appear with distinct
+     * styling in the TUI. They use the same orchestration as regular sessions.
+     * Idempotent: if a system session already exists, it is resumed.
+     */
+    createSystemSession(config: {
+        model?: string;
+        systemMessage?: string;
+        toolNames?: string[];
+        title?: string;
+        onUserInputRequest?: UserInputHandler;
+    }): Promise<PilotSwarmSession>;
+    resumeSession(sessionId: string, config?: ManagedSessionConfig & {
+        onUserInputRequest?: UserInputHandler;
+    }): Promise<PilotSwarmSession>;
+    listSessions(): Promise<PilotSwarmSessionInfo[]>;
+    deleteSession(sessionId: string): Promise<void>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private get _blobEnabled();
+    /** @internal — ensure orchestration exists, update CMS, enqueue prompt. */
+    private _ensureOrchestrationAndSend;
+    /** @internal */
+    _startAndWait(sessionId: string, prompt: string, onUserInput: UserInputHandler | undefined, timeout?: number, onIntermediateContent?: (content: string) => void, opts?: {
+        bootstrap?: boolean;
+    }): Promise<string | undefined>;
+    /** @internal */
+    _startTurn(sessionId: string, prompt: string, opts?: {
+        bootstrap?: boolean;
+    }): Promise<string>;
+    /** @internal */
+    _getDuroxideClient(): any;
+    /** @internal */
+    _getCatalog(): SessionCatalogProvider;
+    /** @internal — exposed for PilotSwarmSession.wait() */
+    _waitForTurnResult_external(orchestrationId: string, sessionId: string, onUserInput: UserInputHandler | undefined, timeout: number): Promise<string | undefined>;
+    /** @internal */
+    private _getLatestResponse;
+    /** @internal */
+    _getSessionInfo(sessionId: string): Promise<PilotSwarmSessionInfo>;
+    /** @internal */
+    private _waitForTurnResult;
+}
+/**
+ * PilotSwarmSession — session handle.
+ * Mirrors CopilotSession API, routes through duroxide orchestration.
+ *
+ * Event delivery:
+ *   on(eventType, handler) — polls CMS session_events table for new events.
+ *   on(handler)            — catch-all, receives every event type.
+ *   Returns unsubscribe function. Polling starts on first subscription.
+ */
+export type SessionEventHandler = (event: SessionEvent) => void;
+export declare class PilotSwarmSession {
+    readonly sessionId: string;
+    private client;
+    private onUserInput?;
+    lastOrchestrationId?: string;
+    private handlers;
+    private lastSeenSeq;
+    private pollTimer;
+    private polling;
+    private static POLL_INTERVAL;
+    /** @internal */
+    constructor(sessionId: string, client: PilotSwarmClient, onUserInput?: UserInputHandler);
+    sendAndWait(prompt: string, timeout?: number, onIntermediateContent?: (content: string) => void): Promise<string | undefined>;
+    send(prompt: string, opts?: {
+        bootstrap?: boolean;
+    }): Promise<void>;
+    wait(timeout?: number): Promise<string | undefined>;
+    /**
+     * Subscribe to session events.
+     *
+     * Overloads:
+     *   on(eventType, handler) — typed subscription (e.g. "assistant.message")
+     *   on(handler)            — catch-all subscription
+     *
+     * Returns an unsubscribe function. Polling starts automatically.
+     */
+    on(eventType: string, handler: SessionEventHandler): () => void;
+    on(handler: SessionEventHandler): () => void;
+    sendEvent(eventName: string, data: unknown): Promise<void>;
+    abort(): Promise<void>;
+    destroy(): Promise<void>;
+    /** Get all persisted events for this session from CMS. */
+    getMessages(limit?: number): Promise<SessionEvent[]>;
+    getInfo(): Promise<PilotSwarmSessionInfo>;
+    private _startPolling;
+    private _stopPolling;
+    private _poll;
+    private _dispatch;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}