pilotswarm-sdk 0.2.2 → 0.3.1

package/dist/session-proxy.d.ts

@@ -22,40 +22,44 @@ export declare function createSessionProxy(ctx: any, sessionId: string, affinity
 };
 export declare function buildRunTurnConfig(inputConfig: SerializableSessionConfig, hostname: string, fallbackAgentIdentity?: string): SerializableSessionConfig;
 /**
- * Derive the app-assigned HARVESTER role from the bound agent definition
- * (enhancedfactstore 07 §1.5 / P4 review BLOCKER#2).
+ * Derive the app-assigned CRAWLER role from the bound agent definition.
  *
- * The harvester role is a property of the AGENT, not of a session: it is
- * resolved from the worker's static, loaded agent definitions every turn by
- * matching the session's resolved identity (agentIdentity / boundAgentName)
- * against each agent's CANONICAL identifier (id / name). Because the agent list
- * is static worker configuration, this is deterministic and replay-safe.
+ * The crawler role is a property of the AGENT, not of a session: it is resolved
+ * from the worker's static, loaded agent definitions every turn by matching the
+ * session's resolved identity (agentIdentity / boundAgentName) against each
+ * agent's CANONICAL identifier (id / name). Because the agent list is static
+ * worker configuration, this is deterministic and replay-safe.
  *
- * Deriving it here (rather than trusting a persisted `isHarvester`) means the
- * role can NEVER be inherited from a parent session or smuggled in via a stale
- * serialized config — a child only becomes a harvester if its OWN bound agent
- * declares `harvester: true`. System agents (e.g. facts-manager) that should be
- * harvester-capable get the tools through the SessionManager gating, not here.
+ * Deriving it here (rather than trusting a persisted `isCrawler` / legacy
+ * `isHarvester`) means the role can NEVER be inherited from a parent session or
+ * smuggled in via a stale serialized config — a child only becomes a crawler if
+ * its OWN bound agent declares `crawler: true` (or legacy `harvester: true`).
+ * System agents (e.g. facts-manager) that should be crawler-capable get the
+ * tools through the SessionManager gating, not here.
  *
  * SECURITY (P5 review BLOCKER#2): `title` is display metadata, NOT an
- * authorization key — matching on it would let a non-harvester whose title
- * normalizes to a harvester's identity receive the privileged crawl queue
- * (`facts_read_uncrawled` / `facts_mark_crawled`, which read facts across ALL
+ * authorization key — matching on it would let a non-crawler whose title
+ * normalizes to a crawler's identity receive the privileged crawl queue
+ * (`facts_read_uncrawled` / `facts_set_crawled`, which read facts across ALL
  * scopes). We match only `id` / `name`, and we FAIL CLOSED on ambiguity: when
  * more than one loaded agent resolves to the same normalized identity, the
- * privileged role is granted only if EVERY one of them declares `harvester`.
+ * privileged role is granted only if EVERY one declares the crawler role.
  */
-export declare function resolveHarvesterRole(identity: string | undefined, boundAgentName: string | undefined, userAgents?: Array<{
+export declare function resolveCrawlerRole(identity: string | undefined, boundAgentName: string | undefined, userAgents?: Array<{
     name?: string;
     id?: string;
     title?: string;
+    crawler?: boolean;
     harvester?: boolean;
 }>, systemAgents?: Array<{
     name?: string;
     id?: string;
     title?: string;
+    crawler?: boolean;
     harvester?: boolean;
 }>): boolean;
+/** @deprecated Use `resolveCrawlerRole`; retained for compatibility. */
+export declare const resolveHarvesterRole: typeof resolveCrawlerRole;
 export declare function createSessionManagerProxy(ctx: any): {
     listModels(): any;
     summarizeSession(sessionId: string): any;
@@ -130,6 +134,7 @@ userAgents?: Array<{
     initialPrompt?: string;
     splash?: string;
     parent?: string;
+    crawler?: boolean;
     harvester?: boolean;
     promptLayerKind?: "app-agent" | "app-system-agent" | "pilotswarm-system-agent";
 }>, 

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

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

package/dist/session-proxy.js

@@ -429,30 +429,30 @@ export function buildRunTurnConfig(inputConfig, hostname, fallbackAgentIdentity)
     return runConfig;
 }
 /**
- * Derive the app-assigned HARVESTER role from the bound agent definition
- * (enhancedfactstore 07 §1.5 / P4 review BLOCKER#2).
+ * Derive the app-assigned CRAWLER role from the bound agent definition.
  *
- * The harvester role is a property of the AGENT, not of a session: it is
- * resolved from the worker's static, loaded agent definitions every turn by
- * matching the session's resolved identity (agentIdentity / boundAgentName)
- * against each agent's CANONICAL identifier (id / name). Because the agent list
- * is static worker configuration, this is deterministic and replay-safe.
+ * The crawler role is a property of the AGENT, not of a session: it is resolved
+ * from the worker's static, loaded agent definitions every turn by matching the
+ * session's resolved identity (agentIdentity / boundAgentName) against each
+ * agent's CANONICAL identifier (id / name). Because the agent list is static
+ * worker configuration, this is deterministic and replay-safe.
  *
- * Deriving it here (rather than trusting a persisted `isHarvester`) means the
- * role can NEVER be inherited from a parent session or smuggled in via a stale
- * serialized config — a child only becomes a harvester if its OWN bound agent
- * declares `harvester: true`. System agents (e.g. facts-manager) that should be
- * harvester-capable get the tools through the SessionManager gating, not here.
+ * Deriving it here (rather than trusting a persisted `isCrawler` / legacy
+ * `isHarvester`) means the role can NEVER be inherited from a parent session or
+ * smuggled in via a stale serialized config — a child only becomes a crawler if
+ * its OWN bound agent declares `crawler: true` (or legacy `harvester: true`).
+ * System agents (e.g. facts-manager) that should be crawler-capable get the
+ * tools through the SessionManager gating, not here.
  *
  * SECURITY (P5 review BLOCKER#2): `title` is display metadata, NOT an
- * authorization key — matching on it would let a non-harvester whose title
- * normalizes to a harvester's identity receive the privileged crawl queue
- * (`facts_read_uncrawled` / `facts_mark_crawled`, which read facts across ALL
+ * authorization key — matching on it would let a non-crawler whose title
+ * normalizes to a crawler's identity receive the privileged crawl queue
+ * (`facts_read_uncrawled` / `facts_set_crawled`, which read facts across ALL
  * scopes). We match only `id` / `name`, and we FAIL CLOSED on ambiguity: when
  * more than one loaded agent resolves to the same normalized identity, the
- * privileged role is granted only if EVERY one of them declares `harvester`.
+ * privileged role is granted only if EVERY one declares the crawler role.
  */
-export function resolveHarvesterRole(identity, boundAgentName, userAgents, systemAgents) {
+export function resolveCrawlerRole(identity, boundAgentName, userAgents, systemAgents) {
     const norm = (v) => (v || "").toLowerCase().replace(/[^a-z0-9]+/g, "");
     const target = norm(identity) || norm(boundAgentName);
     if (!target)
@@ -465,10 +465,13 @@ export function resolveHarvesterRole(identity, boundAgentName, userAgents, syste
     });
     if (matches.length === 0)
         return false;
+    const hasCrawlerRole = (agent) => agent.crawler === true || agent.harvester === true;
     // Fail closed on a normalized-id/name collision: do not let an ambiguous
-    // match between a harvester and a non-harvester escalate to the role.
-    return matches.every((a) => a.harvester === true);
+    // match between a crawler and a non-crawler escalate to the role.
+    return matches.every(hasCrawlerRole);
 }
+/** @deprecated Use `resolveCrawlerRole`; retained for compatibility. */
+export const resolveHarvesterRole = resolveCrawlerRole;
 // ─── SessionManagerProxy ─────────────────────────────────────────
 // The orchestration's view of the SessionManager singleton.
 // Operations that don't require session affinity.
@@ -632,12 +635,13 @@ workerNodeId) {
             fallbackAgentIdentity = row?.agentId ?? undefined;
         }
         const runConfig = buildRunTurnConfig(input.config, hostname, fallbackAgentIdentity);
-        // Derive the app-assigned harvester role authoritatively from the bound
-        // agent definition EVERY turn (enhancedfactstore 07 §1.5 / BLOCKER#2).
+        // Derive the app-assigned crawler role authoritatively from the bound
+        // agent definition EVERY turn.
         // It is a property of the agent, resolved from static worker config, so
         // it survives hydration, is replay-safe, and can never be inherited from
         // a parent or trusted from a stale serialized config.
-        runConfig.isHarvester = resolveHarvesterRole(runConfig.agentIdentity, runConfig.boundAgentName, userAgents, systemAgents);
+        runConfig.isCrawler = resolveCrawlerRole(runConfig.agentIdentity, runConfig.boundAgentName, userAgents, systemAgents);
+        runConfig.isHarvester = runConfig.isCrawler;
         const trace = activityTrace(activityCtx, "runTurn");
         const failForMissingState = async (message) => {
             if (catalog) {
@@ -881,7 +885,7 @@ workerNodeId) {
                             // still apply. The parent is responsible for closing
                             // each instance with complete_agent / cancel_agent /
                             // delete_agent when it no longer needs the child.
-                            const { boundAgentName: _parentBoundAgentName, promptLayering: _parentPromptLayering, isHarvester: _parentIsHarvester, ...parentConfig } = input.config;
+                            const { boundAgentName: _parentBoundAgentName, promptLayering: _parentPromptLayering, isCrawler: _parentIsCrawler, isHarvester: _parentIsHarvester, ...parentConfig } = input.config;
                             const childConfig = {
                                 ...parentConfig,
                                 ...(agentModel ? { model: agentModel } : {}),