pilotswarm-sdk 0.2.0 → 0.2.1

package/dist/storage-config.js

@@ -0,0 +1,138 @@
+export const DEFAULT_RUNTIME_STORAGE_PROVIDER = "postgres";
+export const DEFAULT_DUROXIDE_STORAGE_PROVIDER = "postgres";
+export const DEFAULT_DUROXIDE_SCHEMA = "ps_duroxide";
+export const DEFAULT_CMS_SCHEMA = "copilot_sessions";
+export const DEFAULT_FACTS_SCHEMA = "pilotswarm_facts";
+export const DEFAULT_HORIZON_FACTS_SCHEMA = "horizon_facts";
+const TRUE_VALUES = new Set(["1", "true", "yes", "on"]);
+function trimmed(value) {
+    const t = value?.trim();
+    return t ? t : undefined;
+}
+function first(...values) {
+    for (const value of values) {
+        const t = trimmed(value);
+        if (t)
+            return t;
+    }
+    return undefined;
+}
+function boolFromEnv(value) {
+    const t = trimmed(value)?.toLowerCase();
+    if (t === undefined)
+        return undefined;
+    return TRUE_VALUES.has(t);
+}
+function parseNonNegativeNumber(value, name) {
+    const t = trimmed(value);
+    if (t === undefined)
+        return undefined;
+    const parsed = Number(t);
+    if (!Number.isFinite(parsed) || parsed < 0) {
+        throw new Error(`${name} must be a non-negative number, got ${JSON.stringify(t)}`);
+    }
+    return parsed;
+}
+function embeddingFromEnv(env, prefix) {
+    const stem = prefix === "PILOTSWARM" ? "PILOTSWARM_EMBED" : "HORIZON_EMBED";
+    const url = trimmed(env[`${stem}_URL`]);
+    const model = trimmed(env[`${stem}_MODEL`]);
+    const dimRaw = trimmed(env[`${stem}_DIM`]);
+    const dim = Number.parseInt(dimRaw ?? "", 10);
+    if (!url || !model || !Number.isFinite(dim) || dim <= 0)
+        return undefined;
+    const embedding = { url, model, dim };
+    const apiKey = trimmed(env[`${stem}_API_KEY`]);
+    if (apiKey)
+        embedding.apiKey = apiKey;
+    const apiKeyHeader = trimmed(env[`${stem}_API_KEY_HEADER`]);
+    if (apiKeyHeader)
+        embedding.apiKeyHeader = apiKeyHeader;
+    const bearerRaw = trimmed(env[`${stem}_BEARER`])?.toLowerCase();
+    if (bearerRaw !== undefined) {
+        embedding.bearer = TRUE_VALUES.has(bearerRaw);
+    }
+    else if (apiKeyHeader?.toLowerCase() === "authorization") {
+        embedding.bearer = true;
+    }
+    return embedding;
+}
+function normalizeRuntimeProvider(raw) {
+    if (!raw)
+        return undefined;
+    if (raw === "pg")
+        return "postgres";
+    if (raw === "horizon")
+        return "horizondb";
+    return raw;
+}
+export function resolveStorageConfig(input = {}) {
+    const env = input.env ?? process.env;
+    const options = input.options ?? {};
+    if (options.storageConfig)
+        return options.storageConfig;
+    const databaseUrl = first(options.store, env.DATABASE_URL);
+    if (!databaseUrl) {
+        throw new Error("Storage config requires a store URL via options.store or DATABASE_URL.");
+    }
+    const explicitRuntimeProvider = normalizeRuntimeProvider(first(env.PILOTSWARM_RUNTIME_PROVIDER));
+    const legacySelectsHorizon = !explicitRuntimeProvider && (options.factsProvider === "horizon"
+        || options.factsProvider === "horizondb"
+        || !!trimmed(options.enhancedFactsDatabaseUrl)
+        || !!trimmed(env.HORIZON_DATABASE_URL));
+    const runtimeProvider = normalizeRuntimeProvider(first(explicitRuntimeProvider, legacySelectsHorizon ? "horizondb" : undefined, DEFAULT_RUNTIME_STORAGE_PROVIDER)) ?? DEFAULT_RUNTIME_STORAGE_PROVIDER;
+    const useManagedIdentity = options.useManagedIdentity
+        ?? boolFromEnv(env.PILOTSWARM_USE_MANAGED_IDENTITY)
+        ?? false;
+    const aadDbUser = first(options.aadDbUser, env.PILOTSWARM_AAD_DB_USER, env.AAD_DB_USER);
+    const runtimeUrl = first(env.PILOTSWARM_RUNTIME_URL, databaseUrl);
+    const sessionCatalogUrl = first(options.cmsFactsDatabaseUrl, env.PILOTSWARM_SESSION_CATALOG_URL, env.PILOTSWARM_RUNTIME_SESSION_CATALOG_URL);
+    const explicitFactStoreUrl = first(options.enhancedFactsDatabaseUrl, env.PILOTSWARM_FACTSTORE_URL, env.PILOTSWARM_RUNTIME_FACTS_URL, runtimeProvider === "horizondb" ? env.HORIZON_DATABASE_URL : undefined);
+    const factStoreUrl = explicitFactStoreUrl ?? first(options.cmsFactsDatabaseUrl);
+    const graphUrl = first(options.graphDatabaseUrl, env.PILOTSWARM_GRAPH_URL, env.HORIZON_GRAPH_DATABASE_URL);
+    const graphEnabled = options.graphDatabaseUrl != null
+        || graphUrl != null
+        || boolFromEnv(env.PILOTSWARM_GRAPH_ENABLED) === true;
+    const embedding = options.horizonEmbed
+        ?? embeddingFromEnv(env, "PILOTSWARM")
+        ?? (runtimeProvider === "horizondb" ? embeddingFromEnv(env, "HORIZON") : undefined);
+    const runtimeFactsSchema = runtimeProvider === "horizondb"
+        ? first(options.enhancedFactsSchema, options.factsSchema, env.PILOTSWARM_FACTS_SCHEMA, env.HORIZON_FACTS_SCHEMA, DEFAULT_HORIZON_FACTS_SCHEMA)
+        : first(options.factsSchema, env.PILOTSWARM_FACTS_SCHEMA, DEFAULT_FACTS_SCHEMA);
+    const runtime = {
+        provider: runtimeProvider,
+        url: runtimeUrl,
+        ...(sessionCatalogUrl ? { sessionCatalogUrl } : {}),
+        ...(factStoreUrl ? { factStoreUrl } : {}),
+        cmsSchema: first(options.cmsSchema, env.PILOTSWARM_CMS_SCHEMA, DEFAULT_CMS_SCHEMA),
+        factsSchema: runtimeFactsSchema,
+        ...(embedding ? { embedding } : {}),
+        ...(graphEnabled ? {
+            graph: {
+                enabled: true,
+                ...(graphUrl ? { url: graphUrl } : {}),
+                schema: first(options.graphSchema, env.PILOTSWARM_GRAPH_SCHEMA, env.HORIZON_GRAPH_SCHEMA, "horizon_graph"),
+                ...(first(options.graphRegistrySchema, env.PILOTSWARM_GRAPH_REGISTRY_SCHEMA, env.HORIZON_GRAPH_REGISTRY_SCHEMA)
+                    ? { registrySchema: first(options.graphRegistrySchema, env.PILOTSWARM_GRAPH_REGISTRY_SCHEMA, env.HORIZON_GRAPH_REGISTRY_SCHEMA) }
+                    : {}),
+                ...(options.graphNamespaceCacheTtlMs != null
+                    ? { namespaceCacheTtlMs: options.graphNamespaceCacheTtlMs }
+                    : (() => {
+                        const parsed = parseNonNegativeNumber(first(env.PILOTSWARM_GRAPH_NAMESPACE_CACHE_TTL_MS, env.HORIZON_NAMESPACE_CACHE_TTL_MS), "PILOTSWARM_GRAPH_NAMESPACE_CACHE_TTL_MS");
+                        return parsed != null ? { namespaceCacheTtlMs: parsed } : {};
+                    })()),
+            },
+        } : {}),
+        useManagedIdentity,
+        ...(aadDbUser ? { aadDbUser } : {}),
+    };
+    const duroxide = {
+        provider: first(env.PILOTSWARM_DUROXIDE_PROVIDER, DEFAULT_DUROXIDE_STORAGE_PROVIDER),
+        url: first(env.PILOTSWARM_DUROXIDE_URL, runtime.url),
+        schema: first(options.duroxideSchema, env.PILOTSWARM_DUROXIDE_SCHEMA, DEFAULT_DUROXIDE_SCHEMA),
+        useManagedIdentity,
+        ...(aadDbUser ? { aadDbUser } : {}),
+    };
+    return { runtime, duroxide };
+}
+//# sourceMappingURL=storage-config.js.map

package/dist/storage-config.js.map

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

package/dist/storage-providers.d.ts

@@ -0,0 +1,25 @@
+import { type SessionCatalog } from "./cms.js";
+import { type EnhancedFactStore, type FactStore } from "./facts-store.js";
+import type { GraphStore } from "./graph-store.js";
+import { type DuroxideStorageConfig, type RuntimeStorageConfig } from "./storage-config.js";
+export interface RuntimeStorageProvider {
+    id: string;
+    capabilities: {
+        enhancedFactStore?: true;
+        graphStore?: true;
+        embeddingSupport?: true;
+    };
+    createSessionCatalog(args: RuntimeStorageConfig): Promise<SessionCatalog>;
+    createFactStore(args: RuntimeStorageConfig): Promise<FactStore>;
+    getEnhancedFactStore?(store: FactStore): EnhancedFactStore | undefined;
+    createGraphStore?(args: RuntimeStorageConfig): Promise<GraphStore | undefined>;
+}
+export interface DuroxideStorageProvider {
+    id: string;
+    createDuroxideProvider(args: DuroxideStorageConfig): Promise<unknown>;
+}
+export declare const runtimeStorageProviders: Record<string, RuntimeStorageProvider>;
+export declare const duroxideStorageProviders: Record<string, DuroxideStorageProvider>;
+export declare function getRuntimeStorageProvider(id: string): RuntimeStorageProvider;
+export declare function getDuroxideStorageProvider(id: string): DuroxideStorageProvider;
+//# sourceMappingURL=storage-providers.d.ts.map

package/dist/storage-providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-providers.d.ts","sourceRoot":"","sources":["../src/storage-providers.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AACjE,OAAO,EAIH,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAA2B,KAAK,qBAAqB,EAAE,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAKrH,MAAM,WAAW,sBAAsB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE;QACV,iBAAiB,CAAC,EAAE,IAAI,CAAC;QACzB,UAAU,CAAC,EAAE,IAAI,CAAC;QAClB,gBAAgB,CAAC,EAAE,IAAI,CAAC;KAC3B,CAAC;IACF,oBAAoB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC1E,eAAe,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAChE,oBAAoB,CAAC,CAAC,KAAK,EAAE,SAAS,GAAG,iBAAiB,GAAG,SAAS,CAAC;IACvE,gBAAgB,CAAC,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;CAClF;AAED,MAAM,WAAW,uBAAuB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,sBAAsB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACzE;AAkID,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAG1E,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAE5E,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,MAAM,GAAG,sBAAsB,CAM5E;AAED,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,MAAM,GAAG,uBAAuB,CAM9E"}

package/dist/storage-providers.js

@@ -0,0 +1,150 @@
+import { createRequire } from "node:module";
+import { PgSessionCatalog } from "./cms.js";
+import { createFactStoreForUrl, createGraphStoreForUrl, isEnhancedFactStore, } from "./facts-store.js";
+import { createDuroxidePostgresProvider } from "./duroxide-provider-factory.js";
+import { DEFAULT_DUROXIDE_SCHEMA } from "./storage-config.js";
+const require = createRequire(import.meta.url);
+const { PostgresProvider } = require("duroxide");
+function assertPostgresUrl(url, label) {
+    if (!(url.startsWith("postgres://") || url.startsWith("postgresql://"))) {
+        throw new Error(`${label} requires a PostgreSQL URL, got ${url}`);
+    }
+}
+async function preflightLegacyDuroxideSchema(args, schema) {
+    const legacySchema = typeof args.providerOptions?.legacySchema === "string"
+        ? args.providerOptions.legacySchema
+        : "duroxide";
+    if (schema !== DEFAULT_DUROXIDE_SCHEMA && legacySchema === "duroxide")
+        return;
+    const { default: pg } = await import("pg");
+    const { buildPgPoolConfig } = await import("./pg-pool-factory.js");
+    const pool = new pg.Pool(buildPgPoolConfig({
+        connectionString: args.url,
+        useManagedIdentity: args.useManagedIdentity,
+        aadUser: args.aadDbUser,
+        max: 1,
+    }));
+    try {
+        const { rows } = await pool.query(`
+            SELECT
+                EXISTS (SELECT 1 FROM pg_namespace WHERE nspname = $2) AS legacy_exists,
+                EXISTS (SELECT 1 FROM pg_namespace WHERE nspname = $1) AS target_exists,
+                                EXISTS (
+                                        SELECT 1
+                                        FROM pg_extension e
+                                        JOIN pg_namespace n ON n.oid = e.extnamespace
+                                        WHERE e.extname = 'pg_durable'
+                                              AND n.nspname = $2
+                                ) AS legacy_owned_by_pg_durable,
+                EXISTS (
+                    SELECT 1
+                    FROM information_schema.tables
+                    WHERE table_schema = $2
+                      AND table_name IN ('instances', 'executions', 'history', 'orchestrator_queue', 'worker_queue')
+                ) AS legacy_has_pilotswarm_tables
+        `, [schema, legacySchema]);
+        const row = rows[0] ?? {};
+        if (row.legacy_exists && row.legacy_has_pilotswarm_tables && !row.legacy_owned_by_pg_durable) {
+            throw new Error(`Refusing to use ${schema} while legacy PilotSwarm duroxide schema ${legacySchema} exists. ` +
+                `Run migrateLegacyDuroxideSchema(), remove the legacy schema after confirming it is obsolete, or pin PILOTSWARM_DUROXIDE_SCHEMA=${legacySchema} until a migration window.`);
+        }
+    }
+    finally {
+        await pool.end();
+    }
+}
+const postgresRuntimeStorageProvider = {
+    id: "postgres",
+    capabilities: {},
+    async createSessionCatalog(args) {
+        const url = args.sessionCatalogUrl ?? args.url;
+        assertPostgresUrl(url, "postgres runtime session catalog");
+        return PgSessionCatalog.create(url, args.cmsSchema, {
+            useManagedIdentity: args.useManagedIdentity,
+            aadUser: args.aadDbUser,
+        });
+    },
+    async createFactStore(args) {
+        const url = args.factStoreUrl ?? args.sessionCatalogUrl ?? args.url;
+        return createFactStoreForUrl(url, args.factsSchema, {
+            useManagedIdentity: args.useManagedIdentity,
+            aadUser: args.aadDbUser,
+            provider: "pg",
+        });
+    },
+};
+const horizondbRuntimeStorageProvider = {
+    id: "horizondb",
+    capabilities: {
+        enhancedFactStore: true,
+        graphStore: true,
+        embeddingSupport: true,
+    },
+    async createSessionCatalog(args) {
+        const url = args.sessionCatalogUrl ?? args.url;
+        assertPostgresUrl(url, "horizondb runtime session catalog");
+        return PgSessionCatalog.create(url, args.cmsSchema, {
+            useManagedIdentity: args.useManagedIdentity,
+            aadUser: args.aadDbUser,
+        });
+    },
+    async createFactStore(args) {
+        const url = args.factStoreUrl ?? args.url;
+        return createFactStoreForUrl(url, args.factsSchema, {
+            provider: "horizon",
+            embedding: args.embedding,
+        });
+    },
+    getEnhancedFactStore(store) {
+        return isEnhancedFactStore(store) ? store : undefined;
+    },
+    async createGraphStore(args) {
+        if (!args.graph?.enabled)
+            return undefined;
+        const graphUrl = args.graph.url ?? args.url;
+        const graphSchema = args.graph.schema ?? "horizon_graph";
+        const factsUrl = args.factStoreUrl ?? args.url;
+        if (graphUrl === factsUrl && graphSchema === (args.factsSchema ?? "horizon_facts")) {
+            throw new Error(`graphSchema "${graphSchema}" collides with the facts schema on the same database. ` +
+                `Apache AGE creates a PG schema named after the graph; choose a distinct graphSchema.`);
+        }
+        return createGraphStoreForUrl(graphUrl, graphSchema, {
+            registrySchema: args.graph.registrySchema,
+            namespaceCacheTtlMs: args.graph.namespaceCacheTtlMs,
+        });
+    },
+};
+const postgresDuroxideStorageProvider = {
+    id: "postgres",
+    async createDuroxideProvider(args) {
+        assertPostgresUrl(args.url, "postgres duroxide storage");
+        const schema = args.schema ?? DEFAULT_DUROXIDE_SCHEMA;
+        await preflightLegacyDuroxideSchema(args, schema);
+        return createDuroxidePostgresProvider(PostgresProvider, args.url, schema, {
+            useManagedIdentity: args.useManagedIdentity ?? false,
+            aadUser: args.aadDbUser,
+        });
+    },
+};
+export const runtimeStorageProviders = {
+    postgres: postgresRuntimeStorageProvider,
+    horizondb: horizondbRuntimeStorageProvider,
+};
+export const duroxideStorageProviders = {
+    postgres: postgresDuroxideStorageProvider,
+};
+export function getRuntimeStorageProvider(id) {
+    const provider = runtimeStorageProviders[id];
+    if (!provider) {
+        throw new Error(`Unknown runtime storage provider: ${id}`);
+    }
+    return provider;
+}
+export function getDuroxideStorageProvider(id) {
+    const provider = duroxideStorageProviders[id];
+    if (!provider) {
+        throw new Error(`Unknown duroxide storage provider: ${id}`);
+    }
+    return provider;
+}
+//# sourceMappingURL=storage-providers.js.map

package/dist/storage-providers.js.map

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

package/dist/sweeper-tools.d.ts

@@ -11,7 +11,7 @@
  * @module
  * @internal
  */
-import type { SessionCatalogProvider } from "./cms.js";
+import type { SessionCatalog } from "./cms.js";
 import type { FactStore } from "./facts-store.js";
 import type { Tool } from "@github/copilot-sdk";
 /**
@@ -21,7 +21,7 @@ import type { Tool } from "@github/copilot-sdk";
  * then register the returned tools via `worker.registerTools(tools)`.
  */
 export declare function createSweeperTools(opts: {
-    catalog: SessionCatalogProvider;
+    catalog: SessionCatalog;
     duroxideClient: any;
     factStore?: FactStore | null;
     duroxideSchema?: string;

package/dist/sweeper-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sweeper-tools.d.ts","sourceRoot":"","sources":["../src/sweeper-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEhD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACrC,OAAO,EAAE,sBAAsB,CAAC;IAChC,cAAc,EAAE,GAAG,CAAC;IACpB,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAwWd"}
+{"version":3,"file":"sweeper-tools.d.ts","sourceRoot":"","sources":["../src/sweeper-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEhD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACrC,OAAO,EAAE,cAAc,CAAC;IACxB,cAAc,EAAE,GAAG,CAAC;IACpB,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAwWd"}

package/dist/system-agents.d.ts

@@ -1,5 +1,5 @@
 import { type AgentConfig } from "./agent-loader.js";
-import type { SessionCatalogProvider } from "./cms.js";
+import type { SessionCatalog } from "./cms.js";
 import type { OrchestrationInput, SerializableSessionConfig } from "./types.js";
 export interface SystemAgentSessionPlan {
     agent: AgentConfig & {
@@ -32,7 +32,7 @@ export declare function loadSystemAgentConfigs(opts?: {
 }): AgentConfig[];
 export declare function resolveSystemAgentSessionPlans(agents: AgentConfig[]): SystemAgentSessionPlan[];
 export declare function startSystemAgents(opts: {
-    catalog: Pick<SessionCatalogProvider, "getSession" | "createSession" | "updateSession">;
+    catalog: Pick<SessionCatalog, "getSession" | "createSession" | "updateSession">;
     duroxideClient: any;
     agents: AgentConfig[];
     defaultModel: string;

package/dist/system-agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-agents.d.ts","sourceRoot":"","sources":["../src/system-agents.ts"],"names":[],"mappings":"AAGA,OAAO,EAAyD,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAK5G,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAIhF,MAAM,WAAW,sBAAsB;IACnC,KAAK,EAAE,WAAW,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;CAC5C;AAED,wBAAgB,gCAAgC,CAC5C,KAAK,EAAE,WAAW,EAClB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B,GACF;IACC,kBAAkB,EAAE,yBAAyB,CAAC;IAC9C,KAAK,EAAE,kBAAkB,CAAC;CAC7B,CA2BA;AA4BD,wBAAgB,sBAAsB,CAAC,IAAI,GAAE;IACzC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;CAC3B,GAAG,WAAW,EAAE,CAoBrB;AAED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,sBAAsB,EAAE,CAoD9F;AAcD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC1C,OAAO,EAAE,IAAI,CAAC,sBAAsB,EAAE,YAAY,GAAG,eAAe,GAAG,eAAe,CAAC,CAAC;IACxF,cAAc,EAAE,GAAG,CAAC;IACpB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAkFpC"}
+{"version":3,"file":"system-agents.d.ts","sourceRoot":"","sources":["../src/system-agents.ts"],"names":[],"mappings":"AAGA,OAAO,EAAyD,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAK5G,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAIhF,MAAM,WAAW,sBAAsB;IACnC,KAAK,EAAE,WAAW,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;CAC5C;AAED,wBAAgB,gCAAgC,CAC5C,KAAK,EAAE,WAAW,EAClB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B,GACF;IACC,kBAAkB,EAAE,yBAAyB,CAAC;IAC9C,KAAK,EAAE,kBAAkB,CAAC;CAC7B,CA2BA;AA4BD,wBAAgB,sBAAsB,CAAC,IAAI,GAAE;IACzC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;CAC3B,GAAG,WAAW,EAAE,CAoBrB;AAED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,sBAAsB,EAAE,CAoD9F;AAcD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC1C,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,YAAY,GAAG,eAAe,GAAG,eAAe,CAAC,CAAC;IAChF,cAAc,EAAE,GAAG,CAAC;IACpB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAkFpC"}

package/dist/types.d.ts

@@ -1,7 +1,15 @@
 import type { Tool, SessionConfig } from "@github/copilot-sdk";
 import type { SessionStateStore } from "./session-store.js";
 import type { ReasoningEffort } from "./model-providers.js";
+import type { EmbeddingEndpointConfig } from "./facts-store.js";
+import type { StorageConfig } from "./storage-config.js";
 export declare const SESSION_STATE_MISSING_PREFIX = "SESSION_STATE_MISSING:";
+export type CycleReportStatus = "quiet" | "material" | "blocked";
+export interface CycleReport {
+    status: CycleReportStatus;
+    summary?: string;
+    deltas?: string[];
+}
 export type TurnAction = {
     type: "wait";
     seconds: number;
@@ -102,6 +110,7 @@ export type TurnResult = ({
     type: "completed";
     content: string;
     events?: CapturedEvent[];
+    cycleReport?: CycleReport;
 } & QueuedTurnActionCarrier) | ({
     type: "wait";
     seconds: number;
@@ -217,6 +226,8 @@ export interface TurnOptions {
     bootstrap?: boolean;
     /** Require the Copilot SDK to use a specific tool during this turn. */
     requiredTool?: string;
+    /** Internal: this turn was started by a recurring cron/cron_at timer fire. */
+    cycleOrigin?: "cron" | "cron_at";
     /** Worker-owned inline implementations for non-suspending control tools. */
     controlToolBridge?: {
         spawnAgent(args: {
@@ -317,6 +328,15 @@ export interface SerializableSessionConfig {
      * to enforce knowledge pipeline namespace restrictions.
      */
     agentIdentity?: string;
+    /**
+     * Internal: when `true`, this session holds the app-assigned HARVESTER role
+     * (enhancedfactstore 07 §1.5) and receives the privileged crawl-queue +
+     * graph write/delete tools (only when a graph store is configured). Graph
+     * extraction is app-specific, so the app sets this on its own harvester
+     * agent. The facts-manager receives those tools regardless (dormant), and
+     * agent-tuner never does.
+     */
+    isHarvester?: boolean;
 }
 /** Full config — includes non-serializable fields (tools, hooks). Stays in memory. */
 export interface ManagedSessionConfig extends SerializableSessionConfig {
@@ -502,6 +522,8 @@ export interface OrchestrationInput {
     systemPrompt?: string;
     /** Internal: pending prompt is a bootstrap message, not a user-authored prompt. */
     bootstrapPrompt?: boolean;
+    /** Internal: the pending prompt was produced by a recurring cron/cron_at timer fire. */
+    cycleOrigin?: "cron" | "cron_at";
     /** Seconds above which wait/cron timers proactively dehydrate. Default: 29. */
     dehydrateThreshold?: number;
     idleTimeout?: number;
@@ -581,6 +603,9 @@ export interface OrchestrationInput {
             sessionId: string;
             updateType: string;
             content?: string;
+            cycleOrigin?: "cron" | "cron_at";
+            cycleStatus?: CycleReportStatus;
+            verdict?: ChildSessionVerdict;
             observedAtMs: number;
         }>;
     };
@@ -716,6 +741,12 @@ export interface PilotSwarmWorkerOptions {
      * If not provided, trace messages are discarded.
      */
     traceWriter?: (msg: string) => void;
+    /**
+     * Resolved storage config. When supplied, this is the source of truth for
+     * runtime storage and duroxide storage; legacy flat storage fields are used
+     * only as compatibility inputs when this is omitted.
+     */
+    storageConfig?: StorageConfig;
     /**
      * Custom LLM provider (BYOK — Bring Your Own Key).
      * When specified, uses this API endpoint instead of the GitHub Copilot API.
@@ -737,7 +768,7 @@ export interface PilotSwarmWorkerOptions {
     };
     /**
      * PostgreSQL schema name for duroxide orchestration tables.
-     * Default: `"duroxide"`. Change this to run multiple independent
+    * Default: `"ps_duroxide"`. Change this to run multiple independent
      * deployments on the same database.
      */
     duroxideSchema?: string;
@@ -753,6 +784,60 @@ export interface PilotSwarmWorkerOptions {
      * fact storage across deployments sharing the same database.
      */
     factsSchema?: string;
+    /**
+     * Connection URL for an EnhancedFactStore provider (multi-signal search +
+     * durable embedder), e.g. a HorizonDB cluster with pgvector/pg_textsearch/
+     * pg_durable. When set (or `factsProvider: "horizon"`), the worker constructs
+     * the enhanced provider instead of the default `PgFactStore`.
+     * Resolution: `enhancedFactsDatabaseUrl ?? cmsFactsDatabaseUrl ?? store`.
+     * Unset ⇒ today's behaviour (plain `PgFactStore`).
+     */
+    enhancedFactsDatabaseUrl?: string;
+    /**
+     * Explicit facts-store provider selector. Default inferred: `"horizon"` iff
+     * `enhancedFactsDatabaseUrl` is set, else `"pg"`. Selecting `"horizon"`
+     * dynamically imports `@pilotswarm/horizon-store`; a missing package is a
+     * clear startup error only when horizon is explicitly selected.
+     */
+    factsProvider?: "pg" | "horizon";
+    /**
+     * Schema for the enhanced facts store. Default: `"horizon_facts"`.
+     */
+    enhancedFactsSchema?: string;
+    /**
+     * Embedding endpoint for the enhanced provider's durable in-DB embedder.
+     * Sourced from env (`HORIZON_EMBED_*`). When omitted, semantic search returns
+     * nothing for un-embedded facts (lexical still works).
+     */
+    horizonEmbed?: EmbeddingEndpointConfig;
+    /**
+     * OPT-IN graph store target (Apache AGE). When set, the worker constructs a
+     * separate `GraphStore` provider (`HorizonDBGraphStore`) and graph tools light
+     * up (`!!graphStore`). May be the SAME URL as `enhancedFactsDatabaseUrl` (one
+     * HorizonDB) or a distinct database. Unset ⇒ no graph store, no graph tools —
+     * never selected implicitly.
+     */
+    graphDatabaseUrl?: string;
+    /**
+     * Schema/graph name for the graph store. Default: `"horizon_graph"`.
+     * Apache AGE creates a Postgres schema named after the graph, so on a shared
+     * database this MUST differ from the facts schema — the worker fails fast if
+     * `graphSchema` collides with the facts schema on the same `graphDatabaseUrl`.
+     */
+    graphSchema?: string;
+    /**
+     * Graph-owned relational schema for namespace registry discovery metadata.
+     * Default (provider): `${graphSchema}_registry`. Must differ from
+     * `graphSchema`, because Apache AGE owns a Postgres schema named after the
+     * graph. Env: `HORIZON_GRAPH_REGISTRY_SCHEMA`.
+     */
+    graphRegistrySchema?: string;
+    /**
+     * TTL (ms) for graph namespace list caching inside the graph provider.
+     * Default 60000; set 0 to disable caching. Env:
+     * `HORIZON_NAMESPACE_CACHE_TTL_MS`.
+     */
+    graphNamespaceCacheTtlMs?: number;
     /**
      * Inline app-level default instructions layered beneath the embedded
      * PilotSwarm framework base prompt.
@@ -824,13 +909,18 @@ export interface PilotSwarmClientOptions {
      * If not provided, trace messages are discarded.
      */
     traceWriter?: (msg: string) => void;
+    /**
+     * Resolved storage config. Must match the worker. When supplied, this is
+     * the source of truth for CMS/facts and duroxide storage.
+     */
+    storageConfig?: StorageConfig;
     /** 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`.
+    * Default: `"ps_duroxide"`. Must match the worker's `duroxideSchema`.
      */
     duroxideSchema?: string;
     /**
@@ -843,6 +933,17 @@ export interface PilotSwarmClientOptions {
      * Default: `"pilotswarm_facts"`. Must match the worker's `factsSchema`.
      */
     factsSchema?: string;
+    /**
+     * EnhancedFactStore connection URL (enhancedfactstore 07 P3). Must match the
+     * worker's `enhancedFactsDatabaseUrl` so the client's facts cleanup targets
+     * the same store. Unset ⇒ facts live on `cmsFactsDatabaseUrl ?? store`.
+     */
+    enhancedFactsDatabaseUrl?: string;
+    /** Facts provider selector — must match the worker. Inferred from
+     * `enhancedFactsDatabaseUrl` when omitted. */
+    factsProvider?: "pg" | "horizon";
+    /** Enhanced facts schema — must match the worker's `enhancedFactsSchema`. */
+    enhancedFactsSchema?: string;
     /**
      * Session creation policy. Typically set by the worker and forwarded
      * to co-located clients. Controls which sessions can be created.