pilotswarm-sdk 0.2.0 → 0.2.2

package/dist/horizon-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"horizon-env.d.ts","sourceRoot":"","sources":["../src/horizon-env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAEhE,oFAAoF;AACpF,MAAM,WAAW,gBAAgB;IAC7B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,YAAY,CAAC,EAAE,uBAAuB,CAAC;IACvC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACrC;AAuCD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAChC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACtD,gBAAgB,CAsClB"}

package/dist/horizon-env.js

@@ -0,0 +1,120 @@
+/**
+ * Convenience: build the optional EnhancedFactStore + knowledge-graph worker
+ * config from the canonical `HORIZON_*` environment variables.
+ *
+ * The `PilotSwarmWorker` intentionally does NOT read `process.env` itself — app
+ * entrypoints own env parsing and pass explicit config. This helper exists so the
+ * shipped CLI/portal embedded worker, the standalone K8s worker, and the examples
+ * all map the same env vars to the same worker fields, with no drift.
+ *
+ * Returns an EMPTY object when none of the `HORIZON_*` vars are set (the default —
+ * plain `PgFactStore`, no enhanced provider, no graph). The enhanced facts store and
+ * the knowledge graph are INDEPENDENT axes: setting only `HORIZON_GRAPH_DATABASE_URL`
+ * yields a graph over the base fact store (graph tools, no search). Spread the result
+ * into the worker options:
+ *
+ * ```ts
+ * const worker = new PilotSwarmWorker({
+ *     store: process.env.DATABASE_URL,
+ *     githubToken: process.env.GITHUB_TOKEN,
+ *     ...horizonConfigFromEnv(),
+ * });
+ * ```
+ *
+ * Env vars (all optional except the database URL):
+ *   HORIZON_DATABASE_URL        → enhancedFactsDatabaseUrl (enables the enhanced
+ *                                 provider; worker infers factsProvider="horizon")
+ *   HORIZON_FACTS_SCHEMA        → enhancedFactsSchema (default "horizon_facts")
+ *   HORIZON_GRAPH_DATABASE_URL  → graphDatabaseUrl (opt-in graph; unset ⇒ no graph)
+ *   HORIZON_GRAPH_SCHEMA        → graphSchema (default "horizon_graph")
+ *   HORIZON_GRAPH_REGISTRY_SCHEMA → graphRegistrySchema (default
+ *                                 `${graphSchema}_registry`; MUST differ from graphSchema)
+ *   HORIZON_NAMESPACE_CACHE_TTL_MS → graphNamespaceCacheTtlMs (default 60000; 0 disables cache)
+ *   HORIZON_EMBED_URL/MODEL/DIM → horizonEmbed (durable embedder; all three
+ *                                 required, else the embedder is omitted and
+ *                                 search runs lexical-only)
+ *   HORIZON_EMBED_API_KEY       → horizonEmbed.apiKey
+ *   HORIZON_EMBED_API_KEY_HEADER→ horizonEmbed.apiKeyHeader (default "api-key")
+ *   HORIZON_EMBED_BEARER        → horizonEmbed.bearer (sends "Bearer <key>");
+ *                                 inferred true when the header is "Authorization"
+ *
+ * @module
+ */
+const TRUE_VALUES = new Set(["1", "true", "yes", "on"]);
+function trimmed(value) {
+    const t = value?.trim();
+    return t ? t : undefined;
+}
+/** Assemble the durable embedder endpoint from `HORIZON_EMBED_*`, or `undefined`. */
+function embedFromEnv(env) {
+    const url = trimmed(env.HORIZON_EMBED_URL);
+    const model = trimmed(env.HORIZON_EMBED_MODEL);
+    const dim = Number.parseInt(env.HORIZON_EMBED_DIM ?? "", 10);
+    // The embedder needs all three of url/model/dim. Anything missing ⇒ omit it
+    // (search degrades to lexical-only) rather than crashing the worker.
+    if (!url || !model || !Number.isFinite(dim) || dim <= 0)
+        return undefined;
+    const embed = { url, model, dim };
+    const apiKey = trimmed(env.HORIZON_EMBED_API_KEY);
+    if (apiKey)
+        embed.apiKey = apiKey;
+    const apiKeyHeader = trimmed(env.HORIZON_EMBED_API_KEY_HEADER);
+    if (apiKeyHeader)
+        embed.apiKeyHeader = apiKeyHeader;
+    // `bearer` controls whether the key is sent as "Bearer <key>". Explicit env
+    // wins; otherwise infer it for an Authorization header (OpenAI-style), where
+    // the bearer prefix is required, but not for the Azure "api-key" default.
+    const bearerRaw = trimmed(env.HORIZON_EMBED_BEARER)?.toLowerCase();
+    if (bearerRaw !== undefined) {
+        embed.bearer = TRUE_VALUES.has(bearerRaw);
+    }
+    else if (apiKeyHeader && apiKeyHeader.toLowerCase() === "authorization") {
+        embed.bearer = true;
+    }
+    return embed;
+}
+/**
+ * Map the `HORIZON_*` environment variables to the worker's enhanced-facts /
+ * knowledge-graph config. Pure and side-effect-free; safe to call at startup.
+ *
+ * @param env - Environment source (defaults to `process.env`).
+ */
+export function horizonConfigFromEnv(env = process.env) {
+    const config = {};
+    // Enhanced facts store (+ schema + embedder). The embedder belongs to the
+    // enhanced store, so it is only meaningful when the facts URL is present.
+    const url = trimmed(env.HORIZON_DATABASE_URL);
+    if (url) {
+        config.enhancedFactsDatabaseUrl = url;
+        const factsSchema = trimmed(env.HORIZON_FACTS_SCHEMA);
+        if (factsSchema)
+            config.enhancedFactsSchema = factsSchema;
+        const embed = embedFromEnv(env);
+        if (embed)
+            config.horizonEmbed = embed;
+    }
+    // The knowledge graph is a SEPARATE, opt-in provider on its OWN axis — never
+    // selected implicitly, and INDEPENDENT of the enhanced facts store (07
+    // resolution order: a graph can run over a base fact store, yielding graph
+    // tools but no search tools). Wired purely from its own URL.
+    const graphUrl = trimmed(env.HORIZON_GRAPH_DATABASE_URL);
+    if (graphUrl) {
+        config.graphDatabaseUrl = graphUrl;
+        const graphSchema = trimmed(env.HORIZON_GRAPH_SCHEMA);
+        if (graphSchema)
+            config.graphSchema = graphSchema;
+        const registrySchema = trimmed(env.HORIZON_GRAPH_REGISTRY_SCHEMA);
+        if (registrySchema)
+            config.graphRegistrySchema = registrySchema;
+        const namespaceCacheTtl = trimmed(env.HORIZON_NAMESPACE_CACHE_TTL_MS);
+        if (namespaceCacheTtl !== undefined) {
+            const parsed = Number(namespaceCacheTtl);
+            if (!Number.isFinite(parsed) || parsed < 0) {
+                throw new Error(`HORIZON_NAMESPACE_CACHE_TTL_MS must be a non-negative number, got ${JSON.stringify(namespaceCacheTtl)}`);
+            }
+            config.graphNamespaceCacheTtlMs = parsed;
+        }
+    }
+    return config;
+}
+//# sourceMappingURL=horizon-env.js.map

package/dist/horizon-env.js.map

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

package/dist/index.d.ts

@@ -25,10 +25,20 @@ export { SessionManager } from "./session-manager.js";
 export { ManagedSession } from "./managed-session.js";
 export { SessionBlobStore, createSessionBlobStore } from "./blob-store.js";
 export { FilesystemSessionStore, FilesystemArtifactStore } from "./session-store.js";
-export { PgFactStore, createFactStoreForUrl } from "./facts-store.js";
-export { PgSessionCatalogProvider, computeCacheHitRatio } from "./cms.js";
-export type { SessionCatalogProvider, SessionRow, SessionRowUpdates, SessionEvent, TopEventEmitterRow, InsertTurnMetricInput, TurnMetricRow, HourlyTokenBucketRow, SessionMetricSummary, SessionMetricSummaryUpsert, FleetStats, UserStats, UserStatsBucket, UserStatsModelBucket, UserStatsOwnerKind, SessionTreeStats, SkillKind, SkillUsageRow, SessionTreeSkillUsage, FleetSkillUsageRow, FleetSkillUsage, UserProfile, UserPrincipal } from "./cms.js";
-export type { FactStore, FactRecord, StoreFactInput, ReadFactsQuery, DeleteFactInput, FactsStatsRow, FactsNamespace, } from "./facts-store.js";
+export { PgFactStore, createFactStoreForUrl, createGraphStoreForUrl, resolveFactsTarget, isEnhancedFactStore, EnhancedFactsUnsupportedError } from "./facts-store.js";
+export { horizonConfigFromEnv } from "./horizon-env.js";
+export type { HorizonEnvConfig } from "./horizon-env.js";
+export { resolveStorageConfig, DEFAULT_DUROXIDE_SCHEMA, DEFAULT_RUNTIME_STORAGE_PROVIDER, DEFAULT_DUROXIDE_STORAGE_PROVIDER } from "./storage-config.js";
+export type { StorageConfig, RuntimeStorageConfig, DuroxideStorageConfig, StorageConfigLegacyOptions } from "./storage-config.js";
+export { runtimeStorageProviders, duroxideStorageProviders, getRuntimeStorageProvider, getDuroxideStorageProvider } from "./storage-providers.js";
+export type { RuntimeStorageProvider, DuroxideStorageProvider } from "./storage-providers.js";
+export { migrateLegacyDuroxideSchema } from "./duroxide-schema-migration.js";
+export type { DuroxideSchemaMigrationOptions, DuroxideSchemaMigrationResult } from "./duroxide-schema-migration.js";
+export { PgSessionCatalog, PgSessionCatalogProvider, computeCacheHitRatio } from "./cms.js";
+export type { SessionCatalog, SessionCatalogProvider, SessionRow, SessionRowUpdates, SessionEvent, TopEventEmitterRow, InsertTurnMetricInput, TurnMetricRow, HourlyTokenBucketRow, SessionMetricSummary, SessionMetricSummaryUpsert, FleetStats, UserStats, UserStatsBucket, UserStatsModelBucket, UserStatsOwnerKind, SessionTreeStats, SkillKind, SkillUsageRow, SessionTreeSkillUsage, FleetSkillUsageRow, FleetSkillUsage, RetrievalSurface, RetrievalOperation, RetrievalUsageRow, SessionTreeRetrievalUsage, FleetRetrievalUsageRow, FleetRetrievalUsage, GraphNodeUsageKind, GraphNodeUsageRow, FleetGraphNodeUsageRow, FleetGraphNodeUsage, GraphEdgeSearchUsageRow, UserProfile, UserPrincipal } from "./cms.js";
+export type { FactStore, FactRecord, StoreFactInput, StoredFactResult, ReadFactsQuery, DeleteFactInput, DeletedFactResult, DeletedFactsResult, FactsStatsRow, FactsTombstoneStats, ForcePurgeFactsInput, FactsNamespace, AccessContext, CrawledFactStamp, EnhancedFactStore, FactsCapabilities, SearchMode, SearchWeights, SearchOpts, SimilarOpts, ScoredFact, SearchResult, EmbedderStatus, EmbedderLoopStatus, EmbeddingEndpointConfig, } from "./facts-store.js";
+export { isGraphStore, scopeKeyAccessible, DEFAULT_GRAPH_NAMESPACE } from "./graph-store.js";
+export type { GraphStore, GraphNodeInput, GraphEdgeInput, GraphNodeQuery, GraphEdgeQuery, GraphNamespaceQuery, GraphNodeRef, GraphNodeHit, GraphEdgeRef, GraphEdgeHit, GraphEvidenceRemovalResult, SubGraph, GraphNamespaceFrontmatter, GraphNamespaceInfo, GraphNamespaceInput, GraphNamespaceListQuery, GraphNamespaceDeleteResult, } from "./graph-store.js";
 export type { SessionStateStore, SessionMetadata, ArtifactStore, ArtifactMetadata, ArtifactDownloadResult, ArtifactUploadOptions, ArtifactEncoding, ArtifactSource, } from "./session-store.js";
 export type { PilotSwarmClientOptions, PilotSwarmWorkerOptions, ManagedSessionConfig, PilotSwarmSessionStatus, PilotSwarmSessionInfo, SessionOwnerInfo, SessionContextUsage, SessionCompactionSnapshot, TurnAction, TurnResult, CapturedEvent, UserInputRequest, UserInputResponse, UserInputHandler, CommandMessage, CommandResponse, OrchestrationInput, SubAgentEntry, SessionPolicy, } from "./types.js";
 export { loadSkills } from "./skills.js";
@@ -38,6 +48,7 @@ export type { Skill } from "./skills.js";
 export { LOCAL_DEFAULT_USER_PRINCIPAL } from "./session-owner-utils.js";
 export { createSweeperTools } from "./sweeper-tools.js";
 export { createFactTools } from "./facts-tools.js";
+export { createGraphTools } from "./graph-tools.js";
 export { createInspectTools } from "./inspect-tools.js";
 export { createResourceManagerTools } from "./resourcemgr-tools.js";
 export { loadModelProviders, ModelProviderRegistry } from "./model-providers.js";

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -23,8 +23,15 @@ export { SessionManager } from "./session-manager.js";
 export { ManagedSession } from "./managed-session.js";
 export { SessionBlobStore, createSessionBlobStore } from "./blob-store.js";
 export { FilesystemSessionStore, FilesystemArtifactStore } from "./session-store.js";
-export { PgFactStore, createFactStoreForUrl } from "./facts-store.js";
-export { PgSessionCatalogProvider, computeCacheHitRatio } from "./cms.js";
+export { PgFactStore, createFactStoreForUrl, createGraphStoreForUrl, resolveFactsTarget, isEnhancedFactStore, EnhancedFactsUnsupportedError } from "./facts-store.js";
+// Convenience: map HORIZON_* env vars to worker enhanced-facts/graph config.
+export { horizonConfigFromEnv } from "./horizon-env.js";
+export { resolveStorageConfig, DEFAULT_DUROXIDE_SCHEMA, DEFAULT_RUNTIME_STORAGE_PROVIDER, DEFAULT_DUROXIDE_STORAGE_PROVIDER } from "./storage-config.js";
+export { runtimeStorageProviders, duroxideStorageProviders, getRuntimeStorageProvider, getDuroxideStorageProvider } from "./storage-providers.js";
+export { migrateLegacyDuroxideSchema } from "./duroxide-schema-migration.js";
+export { PgSessionCatalog, PgSessionCatalogProvider, computeCacheHitRatio } from "./cms.js";
+// Graph store contract (optional, separately injected — enhancedfactstore 07 D2)
+export { isGraphStore, scopeKeyAccessible, DEFAULT_GRAPH_NAMESPACE } from "./graph-store.js";
 // Skills loader
 export { loadSkills } from "./skills.js";
 export { loadAgentFiles, systemAgentUUID, systemChildAgentUUID } from "./agent-loader.js";
@@ -35,6 +42,7 @@ export { LOCAL_DEFAULT_USER_PRINCIPAL } from "./session-owner-utils.js";
 export { createSweeperTools } from "./sweeper-tools.js";
 // Fact tools
 export { createFactTools } from "./facts-tools.js";
+export { createGraphTools } from "./graph-tools.js";
 // Inspect tools (read_agent_events, etc.)
 export { createInspectTools } from "./inspect-tools.js";
 // Resource Manager Agent tools

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAElE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAepE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AACrF,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AA2C1E,gBAAgB;AAChB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC1F,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,mFAAmF;AACnF,OAAO,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AACxE,sBAAsB;AACtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,aAAa;AACb,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,0CAA0C;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,+BAA+B;AAC/B,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,kBAAkB;AAClB,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAEjF,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEtG,OAAO,EACH,qBAAqB,EACrB,yBAAyB,EACzB,6BAA6B,GAChC,MAAM,oBAAoB,CAAC;AAO5B,OAAO,EACH,eAAe,EACf,UAAU,EACV,mBAAmB,EACnB,8BAA8B,EAC9B,8BAA8B,EAC9B,eAAe,EACf,yBAAyB,GAC5B,MAAM,0BAA0B,CAAC;AAQlC,OAAO,EACH,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,cAAc,GACjB,MAAM,cAAc,CAAC;AAStB,kBAAkB;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,wDAAwD;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAElE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAepE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AACrF,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAC;AACtK,6EAA6E;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,gCAAgC,EAAE,iCAAiC,EAAE,MAAM,qBAAqB,CAAC;AAEzJ,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAElJ,OAAO,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAE7E,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AA6B5F,iFAAiF;AACjF,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAoD7F,gBAAgB;AAChB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC1F,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,mFAAmF;AACnF,OAAO,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AACxE,sBAAsB;AACtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,aAAa;AACb,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,0CAA0C;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,+BAA+B;AAC/B,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,kBAAkB;AAClB,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAEjF,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEtG,OAAO,EACH,qBAAqB,EACrB,yBAAyB,EACzB,6BAA6B,GAChC,MAAM,oBAAoB,CAAC;AAO5B,OAAO,EACH,eAAe,EACf,UAAU,EACV,mBAAmB,EACnB,8BAA8B,EAC9B,8BAA8B,EAC9B,eAAe,EACf,yBAAyB,GAC5B,MAAM,0BAA0B,CAAC;AAQlC,OAAO,EACH,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,cAAc,GACjB,MAAM,cAAc,CAAC;AAStB,kBAAkB;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,wDAAwD;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/inspect-tools.d.ts

@@ -20,9 +20,9 @@
  * @internal
  */
 import type { Tool } from "@github/copilot-sdk";
-import type { SessionCatalogProvider } from "./cms.js";
+import type { SessionCatalog } from "./cms.js";
 export interface CreateInspectToolsOptions {
-    catalog: SessionCatalogProvider;
+    catalog: SessionCatalog;
     agentIdentity?: string;
     /**
      * Optional duroxide client used by tuner-only tools that read

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

@@ -1 +1 @@
-{"version":3,"file":"inspect-tools.d.ts","sourceRoot":"","sources":["../src/inspect-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,EAAE,sBAAsB,EAAgB,MAAM,UAAU,CAAC;AAqFrE,MAAM,WAAW,yBAAyB;IACtC,OAAO,EAAE,sBAAsB,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,GAAG,CAAC;IACrB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,kBAAkB,EAAE,SAAS,CAAC;CACpD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,yBAAyB,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAmuB/E"}
+{"version":3,"file":"inspect-tools.d.ts","sourceRoot":"","sources":["../src/inspect-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAgB,MAAM,UAAU,CAAC;AAsF7D,MAAM,WAAW,yBAAyB;IACtC,OAAO,EAAE,cAAc,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,GAAG,CAAC;IACrB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,kBAAkB,EAAE,SAAS,CAAC;CACpD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,yBAAyB,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAugC/E"}

package/dist/inspect-tools.js

@@ -20,6 +20,7 @@
  * @internal
  */
 import { defineTool } from "@github/copilot-sdk";
+import { isEnhancedFactStore } from "./facts-store.js";
 import { formatOwnerBucketLabel, formatSessionOwnerLabel, getSessionOwnerKind, matchesOwnerBucketFilters, matchesSessionOwnerFilters } from "./session-owner-utils.js";
 const TUNER_AGENT_ID = "agent-tuner";
 const SYSTEM_AGENT_IDS = new Set([
@@ -97,6 +98,34 @@ export function createInspectTools(opts) {
     const { catalog, agentIdentity, duroxideClient, factStore } = opts;
     const isTuner = agentIdentity === TUNER_AGENT_ID;
     const isSystemAgent = SYSTEM_AGENT_IDS.has(agentIdentity || "");
+    const parseSince = (toolName, sinceIso) => {
+        if (!sinceIso)
+            return undefined;
+        const d = new Date(sinceIso);
+        if (Number.isNaN(d.getTime()))
+            return { error: `${toolName}: invalid since_iso` };
+        return d;
+    };
+    const ensureSelfOrDescendant = async (toolName, targetSessionId, callerSessionId) => {
+        if (isTuner)
+            return null;
+        if (!callerSessionId)
+            return { error: `${toolName}: caller session id is required` };
+        if (targetSessionId === callerSessionId)
+            return null;
+        try {
+            const descendants = await catalog.getDescendantSessionIds(callerSessionId);
+            if (descendants.includes(targetSessionId))
+                return null;
+            return {
+                error: `${toolName}: session_id ${targetSessionId.slice(0, 8)} is not your session or a descendant. ` +
+                    `You may only inspect yourself or sessions in your spawn tree.`,
+            };
+        }
+        catch (err) {
+            return { error: `${toolName}: descendant lookup failed: ${err?.message || String(err)}` };
+        }
+    };
     const readAgentEventsTool = defineTool("read_agent_events", {
         description: "Read durable events from a descendant agent in your spawn tree, paginated by seq cursor. " +
             "Use cursor=null (or omit) for the most recent page; pass the returned prevCursor to walk backwards in time. " +
@@ -400,13 +429,7 @@ export function createInspectTools(opts) {
             }
         },
     });
-    if (!isSystemAgent) {
-        return [readAgentEventsTool];
-    }
     const systemReadTools = [listAllSessionsTool, readSessionInfoTool, readUserStatsTool];
-    if (!isTuner) {
-        return [readAgentEventsTool, ...systemReadTools];
-    }
     // ─── Tuner-only read tools ─────────────────────────────────────────────
     // Bypass the lineage gate; expose CMS state, metric summaries, and
     // (when a duroxide client is provided) orchestration stats and history.
@@ -431,6 +454,45 @@ export function createInspectTools(opts) {
             }
         },
     });
+    const readSessionGraphSearchesTool = defineTool("read_session_graph_searches", {
+        description: "Graph-search forensics: the `graph.searched` events a session emitted — what graph queries it ran " +
+            "(search_nodes / search_edges / neighbourhood, with the query args) and how many results each returned. " +
+            "Use to answer 'what did session X search the graph for, and what did it get back?'",
+        parameters: {
+            type: "object",
+            properties: {
+                session_id: { type: "string" },
+                limit: { type: "number", description: "Max session events to scan (default 500)." },
+            },
+            required: ["session_id"],
+        },
+        handler: async (args) => {
+            const id = normalizeSessionId(args.session_id);
+            try {
+                const events = await catalog.getSessionEvents(id, undefined, args.limit ?? 500);
+                const searches = events
+                    .filter((e) => e.eventType === "graph.searched")
+                    .map((e) => {
+                    const d = e.data ?? {};
+                    return {
+                        seq: e.seq,
+                        at: eventTimestamp(e),
+                        operation: d.operation ?? d.kind ?? "",
+                        namespace: d.namespace ?? null,
+                        nodeKind: d.operation === "graph_search_nodes" ? d.kind ?? null : null,
+                        queryPreview: d.queryPreview ?? d.nameLikePreview ?? null,
+                        resultCount: d.resultCount ?? 0,
+                        nodeCount: d.nodeCount ?? null,
+                        edgeCount: d.edgeCount ?? null,
+                    };
+                });
+                return { sessionId: id, count: searches.length, searches };
+            }
+            catch (err) {
+                return { error: `read_session_graph_searches: ${err?.message || String(err)}` };
+            }
+        },
+    });
     const readSessionTreeStatsTool = defineTool("read_session_tree_stats", {
         description: "Read rolled-up stats across the spawn tree rooted at the given session: " +
             "tokens, snapshot bytes, dehydrations, hydrations, per-descendant breakdown.",
@@ -571,6 +633,190 @@ export function createInspectTools(opts) {
             }
         },
     });
+    const readSessionRetrievalUsageTool = defineTool("read_session_retrieval_usage", {
+        description: "Read per-session retrieval usage for facts_search, facts_similar, search_skills, and graph reads. " +
+            "Returns count-only aggregates from session_events; no returned facts/nodes/edges are stored.",
+        parameters: {
+            type: "object",
+            properties: {
+                session_id: { type: "string" },
+                since_iso: { type: "string", description: "Optional ISO timestamp lower bound." },
+            },
+            required: ["session_id"],
+        },
+        handler: async (args, ctx) => {
+            const id = normalizeSessionId(args.session_id);
+            try {
+                const denied = await ensureSelfOrDescendant("read_session_retrieval_usage", id, ctx?.sessionId);
+                if (denied)
+                    return denied;
+                const since = parseSince("read_session_retrieval_usage", args.since_iso);
+                if (since && "error" in since)
+                    return since;
+                const rows = await catalog.getSessionRetrievalUsage(id, since ? { since } : undefined);
+                return { enabled: true, sessionId: id, rows, totalCalls: rows.reduce((a, r) => a + r.calls, 0) };
+            }
+            catch (err) {
+                return { error: `read_session_retrieval_usage: ${err?.message || String(err)}` };
+            }
+        },
+    });
+    const readSessionTreeRetrievalUsageTool = defineTool("read_session_tree_retrieval_usage", {
+        description: "Read retrieval usage rolled up across a session spawn tree. Parents can use this to understand " +
+            "their children facts/graph consumption; tuner can read any tree.",
+        parameters: {
+            type: "object",
+            properties: {
+                session_id: { type: "string" },
+                since_iso: { type: "string", description: "Optional ISO timestamp lower bound." },
+            },
+            required: ["session_id"],
+        },
+        handler: async (args, ctx) => {
+            const id = normalizeSessionId(args.session_id);
+            try {
+                const denied = await ensureSelfOrDescendant("read_session_tree_retrieval_usage", id, ctx?.sessionId);
+                if (denied)
+                    return denied;
+                const since = parseSince("read_session_tree_retrieval_usage", args.since_iso);
+                if (since && "error" in since)
+                    return since;
+                return await catalog.getSessionTreeRetrievalUsage(id, since ? { since } : undefined);
+            }
+            catch (err) {
+                return { error: `read_session_tree_retrieval_usage: ${err?.message || String(err)}` };
+            }
+        },
+    });
+    const readFleetRetrievalUsageTool = defineTool("read_fleet_retrieval_usage", {
+        description: "Read fleet-wide count-only retrieval usage broken down by agent, surface, operation, and namespace. " +
+            "Always pass since_iso for the default UI/tuner window to keep the scan bounded.",
+        parameters: {
+            type: "object",
+            properties: {
+                include_deleted: { type: "boolean", description: "Default false." },
+                since_iso: { type: "string", description: "Optional ISO timestamp lower bound on event time." },
+            },
+        },
+        handler: async (args) => {
+            try {
+                const since = parseSince("read_fleet_retrieval_usage", args.since_iso);
+                if (since && "error" in since)
+                    return since;
+                return await catalog.getFleetRetrievalUsage({ since: since, includeDeleted: args.include_deleted === true });
+            }
+            catch (err) {
+                return { error: `read_fleet_retrieval_usage: ${err?.message || String(err)}` };
+            }
+        },
+    });
+    const readSessionGraphNodeUsageTool = defineTool("read_session_graph_node_usage", {
+        description: "Read exact graph node-key usage for a session: node keys searched as exact seeds and node keys loaded " +
+            "as neighbourhood anchors. Supports node_key_like and kind searched|loaded.",
+        parameters: {
+            type: "object",
+            properties: {
+                session_id: { type: "string" },
+                since_iso: { type: "string", description: "Optional ISO timestamp lower bound." },
+                limit: { type: "number", description: "Max rows (default 100, max 500)." },
+                node_key_like: { type: "string", description: "Optional substring match over nodeKey." },
+                kind: { type: "string", enum: ["searched", "loaded"], description: "Optional row kind filter." },
+            },
+            required: ["session_id"],
+        },
+        handler: async (args, ctx) => {
+            const id = normalizeSessionId(args.session_id);
+            try {
+                const denied = await ensureSelfOrDescendant("read_session_graph_node_usage", id, ctx?.sessionId);
+                if (denied)
+                    return denied;
+                const since = parseSince("read_session_graph_node_usage", args.since_iso);
+                if (since && "error" in since)
+                    return since;
+                const rows = await catalog.getSessionGraphNodeUsage(id, {
+                    since: since,
+                    limit: args.limit,
+                    nodeKeyLike: args.node_key_like,
+                    kind: args.kind,
+                });
+                return { enabled: true, sessionId: id, rows };
+            }
+            catch (err) {
+                return { error: `read_session_graph_node_usage: ${err?.message || String(err)}` };
+            }
+        },
+    });
+    const readFleetGraphNodeUsageTool = defineTool("read_fleet_graph_node_usage", {
+        description: "Read fleet-wide exact graph node-key usage. Use since_iso plus optional node_key_like/kind to answer " +
+            "how often a node key was searched or loaded over a bounded window.",
+        parameters: {
+            type: "object",
+            properties: {
+                include_deleted: { type: "boolean", description: "Default false." },
+                since_iso: { type: "string", description: "Optional ISO timestamp lower bound on event time." },
+                limit: { type: "number", description: "Max rows (default 100, max 500)." },
+                node_key_like: { type: "string", description: "Optional substring match over nodeKey." },
+                kind: { type: "string", enum: ["searched", "loaded"], description: "Optional row kind filter." },
+            },
+        },
+        handler: async (args) => {
+            try {
+                const since = parseSince("read_fleet_graph_node_usage", args.since_iso);
+                if (since && "error" in since)
+                    return since;
+                return await catalog.getFleetGraphNodeUsage({
+                    since: since,
+                    includeDeleted: args.include_deleted === true,
+                    limit: args.limit,
+                    nodeKeyLike: args.node_key_like,
+                    kind: args.kind,
+                });
+            }
+            catch (err) {
+                return { error: `read_fleet_graph_node_usage: ${err?.message || String(err)}` };
+            }
+        },
+    });
+    const readSessionGraphEdgeSearchUsageTool = defineTool("read_session_graph_edge_search_usage", {
+        description: "Read requested graph edge-search shapes for a session, grouped by predicateKey/fromKey/toKey/namespace.",
+        parameters: {
+            type: "object",
+            properties: {
+                session_id: { type: "string" },
+                since_iso: { type: "string", description: "Optional ISO timestamp lower bound." },
+                limit: { type: "number", description: "Max rows (default 100, max 500)." },
+            },
+            required: ["session_id"],
+        },
+        handler: async (args, ctx) => {
+            const id = normalizeSessionId(args.session_id);
+            try {
+                const denied = await ensureSelfOrDescendant("read_session_graph_edge_search_usage", id, ctx?.sessionId);
+                if (denied)
+                    return denied;
+                const since = parseSince("read_session_graph_edge_search_usage", args.since_iso);
+                if (since && "error" in since)
+                    return since;
+                const rows = await catalog.getSessionGraphEdgeSearchUsage(id, { since: since, limit: args.limit });
+                return { enabled: true, sessionId: id, rows };
+            }
+            catch (err) {
+                return { error: `read_session_graph_edge_search_usage: ${err?.message || String(err)}` };
+            }
+        },
+    });
+    const lineageRetrievalTools = [
+        readSessionRetrievalUsageTool,
+        readSessionTreeRetrievalUsageTool,
+        readSessionGraphNodeUsageTool,
+        readSessionGraphEdgeSearchUsageTool,
+    ];
+    if (!isSystemAgent) {
+        return [readAgentEventsTool, ...lineageRetrievalTools];
+    }
+    if (!isTuner) {
+        return [readAgentEventsTool, ...systemReadTools, ...lineageRetrievalTools];
+    }
     const factsTools = [];
     if (factStore) {
         factsTools.push(defineTool("read_session_facts_stats", {
@@ -646,16 +892,67 @@ export function createInspectTools(opts) {
                 }
             },
         }));
+        factsTools.push(defineTool("read_facts_tombstone_stats", {
+            description: "Read soft-deleted fact tombstone backlog stats. Use to diagnose graph crawler lag: " +
+                "unreconciled tombstones still have last_crawled_at NULL and may strand graph evidence if TTL-purged.",
+            parameters: {
+                type: "object",
+                properties: {
+                    ttl_seconds: { type: "number", description: "Tombstone TTL in seconds. Default 21600 (6h)." },
+                },
+            },
+            handler: async (args) => {
+                try {
+                    return await factStore.getFactsTombstoneStats(args.ttl_seconds);
+                }
+                catch (err) {
+                    return { error: `read_facts_tombstone_stats: ${err?.message || String(err)}` };
+                }
+            },
+        }));
+        // Durable embedder status (07 P5) — semantic/hybrid search only returns
+        // semantic hits while the in-DB embed loop is running. Base PgFactStore
+        // (or an enhanced store with no embedding endpoint) reports unsupported.
+        factsTools.push(defineTool("read_embedder_status", {
+            description: "Read the durable embedder status for the facts store: whether the in-database batch-embedding " +
+                "loop is running. Semantic and hybrid facts_search only return semantic hits while it runs; if it " +
+                "is stopped or unsupported, search is lexical-only. Use when diagnosing why semantic search returns nothing.",
+            parameters: { type: "object", properties: {} },
+            handler: async () => {
+                try {
+                    // Gate ONLY on EnhancedFactStore (guarantees embedderStatus()).
+                    // NOT on construction-time capabilities.embedder — the durable
+                    // loop may be running for the schema even if THIS store was
+                    // built without an embedding endpoint. embedderStatus() reads
+                    // durable df.instances state (the truth).
+                    if (!isEnhancedFactStore(factStore)) {
+                        return { supported: false, note: "facts store has no durable embedder (lexical-only search)." };
+                    }
+                    const st = await factStore.embedderStatus();
+                    return { supported: true, running: st.running, instanceId: st.instanceId, status: st.status };
+                }
+                catch (err) {
+                    return { error: `read_embedder_status: ${err?.message || String(err)}` };
+                }
+            },
+        }));
     }
     const tools = [
         readAgentEventsTool,
         ...systemReadTools,
         readSessionMetricSummaryTool,
+        readSessionGraphSearchesTool,
         readSessionTreeStatsTool,
         readFleetStatsTool,
         readSessionSkillUsageTool,
         readSessionTreeSkillUsageTool,
         readFleetSkillUsageTool,
+        readSessionRetrievalUsageTool,
+        readSessionTreeRetrievalUsageTool,
+        readFleetRetrievalUsageTool,
+        readSessionGraphNodeUsageTool,
+        readFleetGraphNodeUsageTool,
+        readSessionGraphEdgeSearchUsageTool,
         ...factsTools,
     ];
     if (duroxideClient) {