pilotswarm-sdk 0.1.3

package/dist/types.d.ts

@@ -0,0 +1,498 @@
+import type { Tool, SessionConfig } from "@github/copilot-sdk";
+import type { SessionStateStore } from "./session-store.js";
+export declare const SESSION_STATE_MISSING_PREFIX = "SESSION_STATE_MISSING:";
+export type TurnAction = {
+    type: "wait";
+    seconds: number;
+    reason: string;
+    content?: string;
+    events?: CapturedEvent[];
+} | {
+    type: "input_required";
+    question: string;
+    choices?: string[];
+    allowFreeform?: boolean;
+    events?: CapturedEvent[];
+} | {
+    type: "spawn_agent";
+    task: string;
+    model?: string;
+    systemMessage?: string | {
+        mode: "append" | "replace";
+        content: string;
+    };
+    toolNames?: string[];
+    agentName?: string;
+    content?: string;
+    events?: CapturedEvent[];
+} | {
+    type: "message_agent";
+    agentId: string;
+    message: string;
+    events?: CapturedEvent[];
+} | {
+    type: "check_agents";
+    events?: CapturedEvent[];
+} | {
+    type: "wait_for_agents";
+    agentIds: string[];
+    events?: CapturedEvent[];
+} | {
+    type: "list_sessions";
+    events?: CapturedEvent[];
+} | {
+    type: "complete_agent";
+    agentId: string;
+    events?: CapturedEvent[];
+} | {
+    type: "cancel_agent";
+    agentId: string;
+    reason?: string;
+    events?: CapturedEvent[];
+} | {
+    type: "delete_agent";
+    agentId: string;
+    reason?: string;
+    events?: CapturedEvent[];
+};
+type QueuedTurnActionCarrier = {
+    queuedActions?: TurnAction[];
+};
+export type TurnResult = {
+    type: "completed";
+    content: string;
+    events?: CapturedEvent[];
+} | ({
+    type: "wait";
+    seconds: number;
+    reason: string;
+    content?: string;
+    events?: CapturedEvent[];
+} & QueuedTurnActionCarrier) | ({
+    type: "input_required";
+    question: string;
+    choices?: string[];
+    allowFreeform?: boolean;
+    events?: CapturedEvent[];
+} & QueuedTurnActionCarrier) | ({
+    type: "spawn_agent";
+    task: string;
+    model?: string;
+    systemMessage?: string | {
+        mode: "append" | "replace";
+        content: string;
+    };
+    toolNames?: string[];
+    agentName?: string;
+    content?: string;
+    events?: CapturedEvent[];
+} & QueuedTurnActionCarrier) | ({
+    type: "message_agent";
+    agentId: string;
+    message: string;
+    events?: CapturedEvent[];
+} & QueuedTurnActionCarrier) | ({
+    type: "check_agents";
+    events?: CapturedEvent[];
+} & QueuedTurnActionCarrier) | ({
+    type: "wait_for_agents";
+    agentIds: string[];
+    events?: CapturedEvent[];
+} & QueuedTurnActionCarrier) | ({
+    type: "list_sessions";
+    events?: CapturedEvent[];
+} & QueuedTurnActionCarrier) | ({
+    type: "complete_agent";
+    agentId: string;
+    events?: CapturedEvent[];
+} & QueuedTurnActionCarrier) | ({
+    type: "cancel_agent";
+    agentId: string;
+    reason?: string;
+    events?: CapturedEvent[];
+} & QueuedTurnActionCarrier) | ({
+    type: "delete_agent";
+    agentId: string;
+    reason?: string;
+    events?: CapturedEvent[];
+} & QueuedTurnActionCarrier) | {
+    type: "cancelled";
+} | {
+    type: "error";
+    message: string;
+    events?: CapturedEvent[];
+};
+/** A raw event captured from CopilotSession.on() during a turn. */
+export interface CapturedEvent {
+    eventType: string;
+    data: unknown;
+}
+export interface TurnOptions {
+    onDelta?: (delta: string) => void;
+    onToolStart?: (name: string, args: any) => void;
+    /** Called for every event as it fires during the turn. */
+    onEvent?: (event: CapturedEvent) => void;
+    /** Model summary text for the list_available_models tool. */
+    modelSummary?: string;
+    /** Internal: startup/bootstrap turn that should not be recorded as a user message. */
+    bootstrap?: boolean;
+}
+/** Serializable config — travels through duroxide (no functions). */
+export interface SerializableSessionConfig {
+    model?: string;
+    systemMessage?: string | {
+        mode: "append" | "replace";
+        content: string;
+    };
+    workingDirectory?: string;
+    /** Wait threshold in seconds. Waits shorter than this sleep in-process. */
+    waitThreshold?: number;
+    /** Internal: name of the bound agent definition whose prompt should be layered into this session. */
+    boundAgentName?: string;
+    /** Internal: selects how framework, app, and agent prompts compose for this session. */
+    promptLayering?: {
+        kind: "app-agent" | "app-system-agent" | "pilotswarm-system-agent";
+    };
+    /**
+     * Names of tools registered on the worker via `worker.registerTools()`.
+     * Serializable — travels through duroxide. The worker resolves these
+     * names to actual Tool objects from its registry at activity execution time.
+     */
+    toolNames?: string[];
+}
+/** Full config — includes non-serializable fields (tools, hooks). Stays in memory. */
+export interface ManagedSessionConfig extends SerializableSessionConfig {
+    tools?: Tool<any>[];
+    hooks?: SessionConfig["hooks"];
+    /** Turn timeout in milliseconds. 0 or undefined = no timeout. */
+    turnTimeoutMs?: number;
+}
+export type PilotSwarmSessionStatus = "pending" | "running" | "idle" | "waiting" | "input_required" | "completed" | "failed" | "error";
+export interface PilotSwarmSessionInfo {
+    sessionId: string;
+    status: PilotSwarmSessionStatus;
+    /** LLM model used for this session. */
+    model?: string;
+    /** LLM-generated 3-5 word summary of the session. */
+    title?: string;
+    createdAt: Date;
+    updatedAt: Date;
+    pendingQuestion?: {
+        question: string;
+        choices?: string[];
+        allowFreeform?: boolean;
+    };
+    waitingUntil?: Date;
+    waitReason?: string;
+    result?: string;
+    error?: string;
+    iterations: number;
+    /** If this is a sub-agent session, the parent session's ID. */
+    parentSessionId?: string;
+    /** Whether this is a system session (e.g. Sweeper Agent). Cannot be deleted. */
+    isSystem?: boolean;
+    /** Agent definition ID (e.g. "sweeper"). Links session to its agent config. */
+    agentId?: string;
+    /** Splash banner (blessed markup) from the agent definition. */
+    splash?: string;
+}
+export interface OrchestrationInput {
+    sessionId: string;
+    config: SerializableSessionConfig;
+    iteration?: number;
+    responseVersion?: number;
+    commandVersion?: number;
+    affinityKey?: string;
+    needsHydration?: boolean;
+    blobEnabled?: boolean;
+    prompt?: string;
+    /** Internal: pending prompt is a bootstrap message, not a user-authored prompt. */
+    bootstrapPrompt?: boolean;
+    dehydrateThreshold?: number;
+    idleTimeout?: number;
+    inputGracePeriod?: number;
+    /** Timestamp (ms) when the next title summarization should fire. 0 = not yet scheduled. */
+    nextSummarizeAt?: number;
+    /** How many consecutive retries have been attempted for the current prompt. */
+    retryCount?: number;
+    /** The user's original task-defining prompt, preserved to survive LLM truncation. */
+    taskContext?: string;
+    /** Original system message before task context injection (avoids double-appending). */
+    baseSystemMessage?: string | {
+        mode: "append" | "replace";
+        content: string;
+    };
+    /** Seconds between periodic checkpoints (blob upload without losing session pin). -1 = disabled. */
+    checkpointInterval?: number;
+    /** Custom message prepended to the user prompt on rehydration (after worker death). */
+    rehydrationMessage?: string;
+    /** Tracked sub-agents spawned by this orchestration. Carried across continueAsNew. */
+    subAgents?: SubAgentEntry[];
+    /** Durable queue of additional tool actions emitted in the same LLM turn. */
+    pendingToolActions?: TurnAction[];
+    /** One already-dequeued inbound message to replay first after continueAsNew. */
+    pendingMessage?: unknown;
+    /** If this is a sub-agent, the parent session ID (for sending updates back via SDK). */
+    parentSessionId?: string;
+    /** @deprecated Use parentSessionId. Kept for backward compat with frozen orchestration versions. */
+    parentOrchId?: string;
+    /** Current nesting level (0 = root, 1 = child, 2 = grandchild). Used to enforce max depth. */
+    nestingLevel?: number;
+    /** Whether this is a system session (e.g. Sweeper Agent). System sessions skip title summarization. */
+    isSystem?: boolean;
+    /** Agent definition ID bound to this session (e.g. "supervisor"). Used for policy validation. */
+    agentId?: string;
+    /** Session creation policy (loaded from session-policy.json). */
+    sessionPolicy?: SessionPolicy;
+    /** Names of all loaded non-system agents. Used by orchestration to validate policy. */
+    allowedAgentNames?: string[];
+}
+/** A sub-agent entry tracked in the parent orchestration's state. */
+export interface SubAgentEntry {
+    /** The child orchestration ID (e.g. "session-<guid>"). */
+    orchId: string;
+    /** The session ID portion. */
+    sessionId: string;
+    /** Short description of the task assigned to this sub-agent. */
+    task: string;
+    /** Last known status of the sub-agent. */
+    status: "running" | "completed" | "failed" | "cancelled";
+    /** Final result content (set when status becomes completed). */
+    result?: string;
+}
+/**
+ * App-level session creation policy. Loaded from `session-policy.json`
+ * in a plugin directory. Controls which sessions can be created and deleted.
+ */
+export interface SessionPolicy {
+    version: 1;
+    creation?: {
+        /** "allowlist" = only loaded non-system agents; "open" = current behavior. Default: "open". */
+        mode?: "allowlist" | "open";
+        /** Whether generic (blank, no agent) sessions are allowed. Default: true. */
+        allowGeneric?: boolean;
+        /** Default agent name for TUI single-step creation. */
+        defaultAgent?: string;
+    };
+    deletion?: {
+        /** Whether system sessions are protected from deletion. Default: true. */
+        protectSystem?: boolean;
+    };
+}
+export interface PilotSwarmWorkerOptions {
+    store: string;
+    /** GitHub token. Required unless a custom `provider` is specified. */
+    githubToken?: string;
+    logLevel?: "none" | "error" | "warning" | "info" | "debug" | "all";
+    waitThreshold?: number;
+    maxSessionsPerRuntime?: number;
+    sessionIdleTimeoutMs?: number;
+    workerNodeId?: string;
+    /** Azure Blob Storage connection string for the built-in blob-backed session store. */
+    blobConnectionString?: string;
+    /** Blob container name for the built-in blob-backed session store. */
+    blobContainer?: string;
+    /** Optional session state store. When set, enables durable session dehydration without Azure Blob Storage. */
+    sessionStore?: SessionStateStore;
+    /**
+     * Turn timeout in milliseconds. If a single LLM turn takes longer than this,
+     * it is aborted. 0 or undefined = no timeout (default).
+     */
+    turnTimeoutMs?: number;
+    /**
+     * Base directory for local session state files.
+     * Default: `~/.copilot/session-state`.
+     */
+    sessionStateDir?: string;
+    /**
+     * Optional trace callback for startup diagnostics.
+     * If not provided, trace messages are discarded.
+     */
+    traceWriter?: (msg: string) => void;
+    /**
+     * Custom LLM provider (BYOK — Bring Your Own Key).
+     * When specified, uses this API endpoint instead of the GitHub Copilot API.
+     * Eliminates the need for a GitHub token.
+     *
+     * Supports OpenAI-compatible, Azure OpenAI, and Anthropic endpoints.
+     */
+    provider?: {
+        /** Provider type. Defaults to "openai" for generic OpenAI-compatible APIs. */
+        type?: "openai" | "azure" | "anthropic";
+        /** API endpoint URL (e.g. https://my-resource.openai.azure.com/openai/deployments/gpt-4.1-mini) */
+        baseUrl: string;
+        /** API key. Optional for local providers like Ollama. */
+        apiKey?: string;
+        /** Azure-specific options. */
+        azure?: {
+            apiVersion?: string;
+        };
+    };
+    /**
+     * PostgreSQL schema name for duroxide orchestration tables.
+     * Default: `"duroxide"`. Change this to run multiple independent
+     * deployments on the same database.
+     */
+    duroxideSchema?: string;
+    /**
+     * PostgreSQL schema name for the session catalog (CMS) tables.
+     * Default: `"copilot_sessions"`. Change this to isolate session
+     * data across deployments sharing the same database.
+     */
+    cmsSchema?: string;
+    /**
+     * Inline app-level default instructions layered beneath the embedded
+     * PilotSwarm framework base prompt.
+     */
+    systemMessage?: string;
+    /**
+     * Plugin directories to load at startup.
+     * Each directory can contain:
+     *   - `skills/` subdirectories with `SKILL.md` files
+     *   - `agents/` directory with `.agent.md` files
+     *   - `.mcp.json` file with MCP server configs
+     *   - `plugin.json` manifest (optional metadata)
+     *
+     * The worker reads these at startup and passes their contents
+     * through the SDK's `skillDirectories`, `customAgents`, and
+     * `mcpServers` session config fields.
+     */
+    pluginDirs?: string[];
+    /**
+     * Additional skill directories (beyond plugins).
+     * Each directory should contain subdirectories with `SKILL.md` files.
+     * These are passed directly to the SDK's `skillDirectories` config.
+     */
+    skillDirectories?: string[];
+    /**
+     * Additional custom agents (beyond plugins).
+     * Passed directly to the SDK's `customAgents` config.
+     */
+    customAgents?: Array<{
+        name: string;
+        description?: string;
+        prompt: string;
+        tools?: string[] | null;
+    }>;
+    /**
+     * Additional MCP server configs (beyond plugins).
+     * Passed directly to the SDK's `mcpServers` config.
+     */
+    mcpServers?: Record<string, any>;
+    /**
+     * Path to a `model_providers.json` file.
+     * Defines multiple LLM providers (GitHub Copilot, Azure OpenAI, OpenAI, Anthropic)
+     * each with their own endpoints, API keys, and available models.
+     *
+     * If not specified, auto-discovers `.model_providers.json` in cwd or /app/.
+     * Falls back to legacy env vars (LLM_ENDPOINT, GITHUB_TOKEN) if no file found.
+     */
+    modelProvidersPath?: string;
+    /**
+     * Disable SDK-bundled management agents (pilotswarm, resourcemgr, sweeper).
+     * Default: false. Set to true for headless/minimal deployments.
+     */
+    disableManagementAgents?: boolean;
+}
+export interface PilotSwarmClientOptions {
+    /** Store URL (postgres:// or sqlite://). */
+    store: string;
+    /** Enables durable session-store paths in the orchestration. Works with Azure blob or any custom session store configured on workers. */
+    blobEnabled?: boolean;
+    waitThreshold?: number;
+    dehydrateThreshold?: number;
+    dehydrateOnInputRequired?: number;
+    dehydrateOnIdle?: number;
+    /**
+     * Optional trace callback for startup diagnostics.
+     * If not provided, trace messages are discarded.
+     */
+    traceWriter?: (msg: string) => void;
+    /** Seconds between periodic checkpoints (blob upload without losing session pin). -1 = disabled. */
+    checkpointInterval?: number;
+    /** Custom message prepended to the user prompt on rehydration (after worker death). */
+    rehydrationMessage?: string;
+    /**
+     * PostgreSQL schema name for duroxide orchestration tables.
+     * Default: `"duroxide"`. Must match the worker's `duroxideSchema`.
+     */
+    duroxideSchema?: string;
+    /**
+     * PostgreSQL schema name for the session catalog (CMS) tables.
+     * Default: `"copilot_sessions"`. Must match the worker's `cmsSchema`.
+     */
+    cmsSchema?: string;
+    /**
+     * Session creation policy. Typically set by the worker and forwarded
+     * to co-located clients. Controls which sessions can be created.
+     */
+    sessionPolicy?: SessionPolicy;
+    /**
+     * Names of loaded non-system agents. Set by the worker and forwarded
+     * to co-located clients for client-side policy validation.
+     */
+    allowedAgentNames?: string[];
+}
+export interface UserInputRequest {
+    question: string;
+    choices?: string[];
+    allowFreeform?: boolean;
+}
+export interface UserInputResponse {
+    answer: string;
+    wasFreeform: boolean;
+}
+export type UserInputHandler = (request: UserInputRequest, invocation: {
+    sessionId: string;
+}) => Promise<UserInputResponse> | UserInputResponse;
+export interface CommandMessage {
+    type: "cmd";
+    cmd: string;
+    args?: Record<string, unknown>;
+    id: string;
+}
+export interface CommandResponse {
+    id: string;
+    cmd: string;
+    result?: unknown;
+    error?: string;
+}
+export declare const RESPONSE_VERSION_KEY = "meta.responseVersion";
+export declare const COMMAND_VERSION_KEY = "meta.commandVersion";
+export declare const RESPONSE_LATEST_KEY = "response.latest";
+export declare function commandResponseKey(cmdId: string): string;
+export interface SessionResponsePayload {
+    schemaVersion: 1;
+    version: number;
+    iteration: number;
+    type: "completed" | "wait" | "input_required";
+    content?: string;
+    question?: string;
+    choices?: string[];
+    allowFreeform?: boolean;
+    waitReason?: string;
+    waitSeconds?: number;
+    waitStartedAt?: number;
+    emittedAt: number;
+    model?: string;
+}
+export interface SessionCommandResponse extends CommandResponse {
+    schemaVersion: 1;
+    version: number;
+    emittedAt: number;
+}
+export interface SessionStatusSignal {
+    status: PilotSwarmSessionStatus;
+    iteration: number;
+    responseVersion?: number;
+    commandVersion?: number;
+    commandId?: string;
+    cmdProcessing?: string;
+    waitReason?: string;
+    waitSeconds?: number;
+    waitStartedAt?: number;
+    error?: string;
+    retriesExhausted?: boolean;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,9 @@
+export const SESSION_STATE_MISSING_PREFIX = "SESSION_STATE_MISSING:";
+// ─── KV-Backed Response Channel ────────────────────────────────
+export const RESPONSE_VERSION_KEY = "meta.responseVersion";
+export const COMMAND_VERSION_KEY = "meta.commandVersion";
+export const RESPONSE_LATEST_KEY = "response.latest";
+export function commandResponseKey(cmdId) {
+    return `command.response.${cmdId}`;
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,4BAA4B,GAAG,wBAAwB,CAAC;AAibrE,kEAAkE;AAElE,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAAsB,CAAC;AAC3D,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AACzD,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAErD,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC5C,OAAO,oBAAoB,KAAK,EAAE,CAAC;AACvC,CAAC"}

package/dist/worker.d.ts

@@ -0,0 +1,128 @@
+import type { SessionCatalogProvider } from "./cms.js";
+import { type ModelProviderRegistry } from "./model-providers.js";
+import type { Tool } from "@github/copilot-sdk";
+import type { PilotSwarmWorkerOptions, ManagedSessionConfig } from "./types.js";
+import type { AgentConfig } from "./agent-loader.js";
+/**
+ * PilotSwarmWorker — runs activities and orchestrations.
+ *
+ * Owns:
+ *   - SessionManager (creates/resumes CopilotSessions, holds tools/hooks)
+ *   - duroxide Runtime (dispatches activities + orchestrations)
+ *   - Session state store (optional, for session dehydration/hydration)
+ *
+ * In single-process mode, pass this worker to PilotSwarmClient's
+ * constructor so they share the database provider and the client can
+ * forward tool/hook registrations.
+ */
+export declare class PilotSwarmWorker {
+    private config;
+    private sessionManager;
+    private sessionStore;
+    private blobStore;
+    private runtime;
+    private _provider;
+    private _catalog;
+    private _started;
+    /** Worker-level tool registry — name → Tool. */
+    private toolRegistry;
+    /** Loaded skill directories from plugins + direct config. */
+    private _loadedSkillDirs;
+    /** Raw loaded user-creatable agent configs from plugins + direct config. */
+    private _rawLoadedAgents;
+    /** Loaded agent configs from plugins + direct config, composed for SDK customAgents. */
+    private _loadedAgents;
+    /** Loaded MCP server configs from plugins + direct config. */
+    private _loadedMcpServers;
+    /** Model provider registry — multi-provider LLM config. */
+    private _modelProviders;
+    /** Embedded PilotSwarm framework prompt. */
+    private _frameworkBasePrompt;
+    /** App-level default prompt overlay from app pluginDirs and inline worker config. */
+    private _appDefaultPrompt;
+    /** System agents loaded from plugins — started automatically on worker start. */
+    private _loadedSystemAgents;
+    /** Prompt lookup used for direct named/system sessions. */
+    private _agentPromptLookup;
+    /** Session creation policy loaded from session-policy.json. */
+    private _sessionPolicy;
+    constructor(options: PilotSwarmWorkerOptions);
+    /**
+     * Register tools at the worker level.
+     *
+     * These tools are available to ALL sessions on this worker.
+    * Clients can reference them by name in createSession() via
+    * `toolNames: ["tool_name_1", "tool_name_2"]` — the names travel
+     * through duroxide as serializable strings, and the worker
+     * resolves them to the actual Tool objects at execution time.
+     *
+     * This is the primary mechanism for custom tools in remote/
+     * separate-process mode where client and worker run on
+     * different machines.
+     */
+    registerTools(tools: Tool<any>[]): void;
+    /** Store full config (with tools/hooks) for a session. */
+    setSessionConfig(sessionId: string, config: ManagedSessionConfig): void;
+    /** Whether a durable session store is configured. */
+    get blobEnabled(): boolean;
+    /** Whether the worker runtime is running. */
+    get isStarted(): boolean;
+    /** @internal — shared with co-located PilotSwarmClient. */
+    get provider(): any;
+    /** Session catalog (CMS) — available when store is PostgreSQL. */
+    get catalog(): SessionCatalogProvider | null;
+    /** Loaded skill directories. */
+    get loadedSkillDirs(): string[];
+    /** Loaded agent configs. */
+    get loadedAgents(): Array<{
+        name: string;
+        description?: string;
+        prompt: string;
+        tools?: string[] | null;
+        namespace?: string;
+    }>;
+    /** Loaded MCP server configs. */
+    get loadedMcpServers(): Record<string, any>;
+    /** Model provider registry (null if no providers configured). */
+    get modelProviders(): ModelProviderRegistry | null;
+    /** System agents loaded from plugins. */
+    get systemAgents(): AgentConfig[];
+    /** Session creation policy (null if no session-policy.json found). */
+    get sessionPolicy(): import("./types.js").SessionPolicy | null;
+    /** Names of loaded non-system agents that can be created as top-level sessions. */
+    get allowedAgentNames(): string[];
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /** Dehydrate all active sessions, then stop. */
+    gracefulShutdown(): Promise<void>;
+    /** Destroy a session on this worker. */
+    destroySession(sessionId: string): Promise<void>;
+    /**
+     * Load plugin contents from SDK bundled plugins + app plugin directories.
+     *
+     * Three-tier loading order:
+     *   1. system/  — SDK core (always loaded: base system prompt, durable-timers, sub-agents)
+     *   2. mgmt/    — SDK management agents (loaded unless disableManagementAgents is true)
+     *   3. app      — Consumer-provided plugin dirs (from pluginDirs option)
+     *   4. direct   — Inline config (skillDirectories, customAgents, mcpServers options)
+     *
+     * Agents merge by name (later tiers override earlier).
+     * Skills merge additively (all dirs combined).
+     * MCP servers merge by name (later tiers override earlier).
+     */
+    private _loadPlugins;
+    /**
+     * Load agents, skills, MCP config, and session policy from a single plugin directory.
+     */
+    private _loadPluginDir;
+    /**
+     * Auto-start system agents defined in plugins.
+     *
+     * Each system agent has a deterministic session UUID derived from its `id` slug.
+     * Multiple workers calling this concurrently is safe — CMS upsert and
+     * duroxide startOrchestrationVersioned are both idempotent.
+     */
+    private _startSystemAgents;
+    private _createProvider;
+}
+//# sourceMappingURL=worker.d.ts.map

package/dist/worker.d.ts.map

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