@elevasis/sdk 1.54.0 → 1.56.0

package/dist/cli.cjs

@@ -23791,14 +23791,25 @@ var init_systems = __esm({
        * position-derived paths. Both still exist on this schema for backward compat.
        */
       systems: external_exports.lazy(() => external_exports.record(external_exports.string().trim().min(1).max(100), SystemEntrySchema)).optional(),
-      /** @deprecated Use systems. Accepted as a compatibility alias during the ontology bridge. */
+      /**
+       * @deprecated Use systems. Accepted as a compatibility alias during the ontology bridge.
+       *
+       * Accepted on INPUT only. Parsing used to mirror `systems` into this key so that
+       * either spelling could be read off a parsed model, which meant every parsed System
+       * carried the same children twice. Readers that walked both keys then visited each
+       * nested System twice -- `getOrgOsRouteContractSystems` reported 11 checked paths
+       * against command-center's 7 real Systems and would have raised every nested-System
+       * failure as two failures -- and readers that walked this key alone looked correct
+       * while depending entirely on the mirror. Both defects were live. The mirror is gone:
+       * a parsed model now carries children under whichever key the author wrote, so read
+       * `system.systems ?? system.subsystems` (helpers.ts, validation.ts, ontology.ts,
+       * selectDeclaredSystems.ts, validateManifests.ts and SystemOpsView.tsx all do).
+       */
       subsystems: external_exports.lazy(() => external_exports.record(external_exports.string().trim().min(1).max(100), SystemEntrySchema)).optional()
     }).strict().refine((system) => system.label !== void 0 || system.title !== void 0, {
       path: ["label"],
       message: "System must provide label or title"
-    }).transform(
-      (system) => system.systems !== void 0 && system.subsystems === void 0 ? { ...system, subsystems: system.systems } : system
-    );
+    });
     SystemsDomainSchema = external_exports.record(external_exports.string(), SystemEntrySchema).refine((record2) => Object.entries(record2).every(([key, entry]) => entry.id === key), {
       message: "Each system entry id must match its map key"
     }).default({});
@@ -47048,6 +47059,20 @@ var init_api2 = __esm({
   }
 });
 
+// ../core/src/platform/errors/index.ts
+var init_errors6 = __esm({
+  "../core/src/platform/errors/index.ts"() {
+    "use strict";
+  }
+});
+
+// ../core/src/platform/errors/disclosure.ts
+var init_disclosure = __esm({
+  "../core/src/platform/errors/disclosure.ts"() {
+    "use strict";
+  }
+});
+
 // ../core/src/platform/index.ts
 var init_platform = __esm({
   "../core/src/platform/index.ts"() {
@@ -47057,6 +47082,8 @@ var init_platform = __esm({
     init_registry();
     init_sse();
     init_api2();
+    init_errors6();
+    init_disclosure();
   }
 });
 
@@ -47424,7 +47451,7 @@ var init_sse_executions = __esm({
 });
 
 // ../core/src/execution/core/api-schemas.ts
-var PayloadSchema, OptionalPayloadSchema, ExecutionTargetSchema, OriginTrackingSchema, ExternalExecuteRequestSchema, ExternalExecuteResponseSchema, ExecutionEngineExecuteRequestSchema, ExecutionEngineExecuteResponseSchema, CreateCommandQueueTaskSchema, SubmitDecisionSchema, ListCommandQueueTasksSchema, ListExecutionsSchema, DeleteExecutionsSchema;
+var PayloadSchema, OptionalPayloadSchema, ExecutionTargetSchema, OriginTrackingSchema, ExternalExecuteRequestSchema, ExternalExecuteResponseSchema, ExecutionEngineExecuteRequestSchema, ExecutionEngineExecuteResponseSchema, CreateCommandQueueTaskSchema, SubmitDecisionSchema, ListCommandQueueTasksSchema, ExecutionStatusSchema, ResourceIdParamSchema, ResourceExecutionParamsSchema, ListExecutionsSchema, ListAllExecutionsSchema, DeleteExecutionsSchema, PatchExecutionBodySchema;
 var init_api_schemas = __esm({
   "../core/src/execution/core/api-schemas.ts"() {
     "use strict";
@@ -47506,12 +47533,35 @@ var init_api_schemas = __esm({
       status: external_exports.enum(["pending", "approved", "rejected", "expired"]).optional(),
       limit: PageLimitSchema.default(20)
     }).strict();
-    ListExecutionsSchema = external_exports.object({
-      resourceStatus: external_exports.enum(["dev", "prod", "all"]).default("all")
+    ExecutionStatusSchema = external_exports.enum(["pending", "running", "completed", "failed", "warning"]);
+    ResourceIdParamSchema = external_exports.object({
+      resourceId: NonEmptyStringSchema.max(255)
     }).strict();
+    ResourceExecutionParamsSchema = external_exports.object({
+      resourceId: NonEmptyStringSchema.max(255),
+      executionId: NonEmptyStringSchema.max(255)
+    }).strict();
+    ListExecutionsSchema = external_exports.object({
+      resourceStatus: external_exports.enum(["dev", "prod", "all"]).default("all"),
+      limit: PageLimitSchema.default(DEFAULT_PAGE_LIMIT),
+      offset: PageOffsetSchema
+    });
+    ListAllExecutionsSchema = external_exports.object({
+      resourceId: NonEmptyStringSchema.max(255).optional(),
+      status: external_exports.enum([...ExecutionStatusSchema.options, "all"]).optional(),
+      resourceStatus: external_exports.enum(["dev", "prod", "all"]).optional(),
+      startDate: external_exports.coerce.number().int().nonnegative().optional(),
+      endDate: external_exports.coerce.number().int().nonnegative().optional(),
+      limit: PageLimitSchema.default(DEFAULT_PAGE_LIMIT),
+      offset: PageOffsetSchema
+    });
     DeleteExecutionsSchema = external_exports.object({
       resourceStatus: external_exports.enum(["dev", "prod"]).optional()
     }).strict();
+    PatchExecutionBodySchema = external_exports.object({
+      status: external_exports.enum(["completed", "failed", "warning"]),
+      error: external_exports.string().max(5e3).optional()
+    }).strict();
   }
 });
 
@@ -48149,6 +48199,85 @@ var init_schemas6 = __esm({
   }
 });
 
+// ../core/src/operations/observability/api-schemas.ts
+var ErrorSeveritySchema, ExecutionIdParamSchema, ErrorIdParamSchema, ObservabilityDateRangeQuerySchema, ExecutionLogsQuerySchema, ErrorDetailsQuerySchema, ErrorDistributionQuerySchema, ErrorTrendsQuerySchema, TopFailingResourcesQuerySchema, RecentExecutionsByResourceQuerySchema, CostTrendsQuerySchema, ResourceHealthTargetSchema, ResourcesHealthBodySchema, SystemHealthResourceKindSchema, SystemHealthResourceDescriptorSchema, SystemHealthBodySchema;
+var init_api_schemas3 = __esm({
+  "../core/src/operations/observability/api-schemas.ts"() {
+    "use strict";
+    init_zod();
+    init_validation();
+    ErrorSeveritySchema = external_exports.enum(["critical", "warning", "info"]);
+    ExecutionIdParamSchema = external_exports.object({ executionId: NonEmptyStringSchema.max(255) }).strict();
+    ErrorIdParamSchema = external_exports.object({ errorId: external_exports.string().uuid() }).strict();
+    ObservabilityDateRangeQuerySchema = external_exports.object({
+      startDate: TimestampSchema.optional(),
+      endDate: TimestampSchema.optional()
+    });
+    ExecutionLogsQuerySchema = ObservabilityDateRangeQuerySchema.extend({
+      page: external_exports.coerce.number().int().min(1).default(1),
+      limit: PageLimitSchema.default(DEFAULT_PAGE_LIMIT),
+      // Left as bounded strings rather than enums. The service passes both straight into `.eq()`, and an
+      // unknown value returns an empty page rather than misbehaving — so an enum here would assert a
+      // catalog this schema has no way to keep in step with the column.
+      resourceType: external_exports.string().max(100).optional(),
+      status: external_exports.string().max(50).optional(),
+      search: external_exports.string().max(200).optional()
+    });
+    ErrorDetailsQuerySchema = ObservabilityDateRangeQuerySchema.extend({
+      page: external_exports.coerce.number().int().min(1).default(1),
+      limit: PageLimitSchema.default(DEFAULT_PAGE_LIMIT),
+      errorType: external_exports.string().max(100).optional(),
+      severity: ErrorSeveritySchema.optional(),
+      search: external_exports.string().max(200).optional(),
+      // Tri-state on the wire: 'true' and 'false' filter, anything else (including 'all', which the
+      // Command Center sends) means no filter. Coercing to a boolean here would make 'all' read as true.
+      resolved: external_exports.enum(["true", "false", "all"]).optional()
+    });
+    ErrorDistributionQuerySchema = ObservabilityDateRangeQuerySchema.extend({
+      groupBy: external_exports.enum(["type", "severity"]).default("type")
+    });
+    ErrorTrendsQuerySchema = ObservabilityDateRangeQuerySchema.extend({
+      granularity: external_exports.enum(["hour", "day"]).default("day")
+    });
+    TopFailingResourcesQuerySchema = ObservabilityDateRangeQuerySchema.extend({
+      limit: PageLimitSchema.default(10)
+    });
+    RecentExecutionsByResourceQuerySchema = ObservabilityDateRangeQuerySchema.extend({
+      limit: PageLimitSchema.optional()
+    });
+    CostTrendsQuerySchema = ObservabilityDateRangeQuerySchema.extend({
+      granularity: external_exports.enum(["hour", "day"]).default("hour")
+    });
+    ResourceHealthTargetSchema = external_exports.object({
+      entityType: NonEmptyStringSchema.max(100),
+      entityId: NonEmptyStringSchema.max(255)
+    }).strict();
+    ResourcesHealthBodySchema = external_exports.object({
+      resources: external_exports.array(ResourceHealthTargetSchema).min(1).max(20),
+      startDate: TimestampSchema,
+      endDate: TimestampSchema,
+      granularity: external_exports.enum(["hour", "day"])
+    }).strict();
+    SystemHealthResourceKindSchema = external_exports.enum(["workflow", "agent", "integration", "script"]);
+    SystemHealthResourceDescriptorSchema = external_exports.object({
+      id: NonEmptyStringSchema.max(255),
+      kind: SystemHealthResourceKindSchema,
+      systemPath: external_exports.string().max(500).optional(),
+      executable: external_exports.boolean().optional()
+    }).strict();
+    SystemHealthBodySchema = external_exports.object({
+      systemPath: NonEmptyStringSchema.max(500),
+      includeDescendants: external_exports.boolean().optional(),
+      startDate: TimestampSchema,
+      endDate: TimestampSchema,
+      granularity: external_exports.enum(["hour", "day"]).optional(),
+      directResources: external_exports.array(SystemHealthResourceDescriptorSchema).optional(),
+      descendantResources: external_exports.array(SystemHealthResourceDescriptorSchema).optional(),
+      resources: external_exports.array(SystemHealthResourceDescriptorSchema).optional()
+    }).strict();
+  }
+});
+
 // ../core/src/operations/observability/utils.ts
 var init_utils5 = __esm({
   "../core/src/operations/observability/utils.ts"() {
@@ -48162,6 +48291,7 @@ var init_observability = __esm({
     "use strict";
     init_types13();
     init_schemas6();
+    init_api_schemas3();
     init_utils5();
   }
 });
@@ -48192,7 +48322,7 @@ var init_types14 = __esm({
 
 // ../core/src/operations/activities/api-schemas.ts
 var ActivityTypeSchema, ActivityStatusSchema, MetadataSchema, CreateActivitySchema, ActivityTrendQuerySchema, ListActivitiesQuerySchema;
-var init_api_schemas3 = __esm({
+var init_api_schemas4 = __esm({
   "../core/src/operations/activities/api-schemas.ts"() {
     "use strict";
     init_zod();
@@ -48250,7 +48380,7 @@ var init_activities = __esm({
   "../core/src/operations/activities/index.ts"() {
     "use strict";
     init_types14();
-    init_api_schemas3();
+    init_api_schemas4();
     init_sse_events3();
   }
 });
@@ -48689,7 +48819,7 @@ var init_acquisition = __esm({
 
 // ../core/src/business/clients/api-schemas.ts
 var ClientStatusSchema, ClientSourceSchema, ClientIdParamsSchema, ListClientsQuerySchema, ClientRefSchema, ClientResponseSchema, ClientDealRefSchema, ClientProjectRefSchema, ClientCompanyRefSchema, ClientContactRefSchema, ClientLineageSchema, ClientDetailResponseSchema, ClientListResponseSchema, ClientStatusResponseSchema, CreateClientRequestSchema, UpdateClientRequestSchema;
-var init_api_schemas4 = __esm({
+var init_api_schemas5 = __esm({
   "../core/src/business/clients/api-schemas.ts"() {
     "use strict";
     init_zod();
@@ -48803,7 +48933,7 @@ var init_api_schemas4 = __esm({
 var init_clients = __esm({
   "../core/src/business/clients/index.ts"() {
     "use strict";
-    init_api_schemas4();
+    init_api_schemas5();
   }
 });
 
@@ -48951,18 +49081,26 @@ var init_provider_registry = __esm({
   }
 });
 
+// ../core/src/integrations/oauth/errors.ts
+var init_errors7 = __esm({
+  "../core/src/integrations/oauth/errors.ts"() {
+    "use strict";
+  }
+});
+
 // ../core/src/integrations/oauth/index.ts
 var init_oauth = __esm({
   "../core/src/integrations/oauth/index.ts"() {
     "use strict";
     init_types19();
     init_provider_registry();
+    init_errors7();
   }
 });
 
 // ../core/src/integrations/credentials/api-schemas.ts
 var CredentialTypeSchema, CredentialValueSchema, CreateCredentialRequestSchema, CreateCredentialResponseSchema, ListCredentialsResponseSchema, UpdateCredentialParamsSchema, UpdateCredentialRequestSchema, DeleteCredentialParamsSchema, VerifyCredentialParamsSchema, VerifyCredentialResponseSchema;
-var init_api_schemas5 = __esm({
+var init_api_schemas6 = __esm({
   "../core/src/integrations/credentials/api-schemas.ts"() {
     "use strict";
     init_zod();
@@ -49038,7 +49176,7 @@ var init_api_schemas5 = __esm({
 var init_credentials2 = __esm({
   "../core/src/integrations/credentials/index.ts"() {
     "use strict";
-    init_api_schemas5();
+    init_api_schemas6();
   }
 });
 
@@ -49439,7 +49577,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@elevasis/sdk",
-      version: "1.54.0",
+      version: "1.56.0",
       description: "SDK for building Elevasis organization resources",
       type: "module",
       bin: {
@@ -54633,7 +54771,7 @@ function formatText(results) {
   const divider = "-".repeat(header.length + 20);
   const rows = results.map((n) => {
     const summary = n.summary.length > 80 ? n.summary.slice(0, 77) + "..." : n.summary;
-    return `${n.kind.padEnd(kindWidth)}  ${n.id.padEnd(idWidth)}  ${n.title}  \xE2\u20AC\u201D  ${summary}`;
+    return `${n.kind.padEnd(kindWidth)}  ${n.id.padEnd(idWidth)}  ${n.title}  \u2014  ${summary}`;
   });
   return [header, divider, ...rows].join("\n");
 }

package/dist/index.d.ts

@@ -1591,6 +1591,16 @@ interface WorkflowStep extends WorkflowStepDefinition {
     inputSchema: z.ZodSchema;
     outputSchema: z.ZodSchema;
     next: NextConfig;
+    /**
+     * How long this one step may run, in milliseconds. Omitted, the step is bounded only by the
+     * execution ceiling (`DEFAULT_EXECUTION_TIMEOUT`, 2 hours), which is what every step used to get.
+     *
+     * `WorkflowConfig` deliberately still has no `constraints` field: a per-workflow override would
+     * only restate the execution ceiling the caller already sets when it arms the deadline, whereas
+     * "this HTTP step should never take more than 5 seconds" is a property of the step and has no
+     * other place to live.
+     */
+    timeout?: number;
 }
 interface WorkflowDefinition {
     config: WorkflowConfig;
@@ -4387,13 +4397,6 @@ type Database = {
                         referencedRelation: "users";
                         referencedColumns: ["id"];
                     },
-                    {
-                        foreignKeyName: "prj_notes_milestone_id_fkey";
-                        columns: ["milestone_id"];
-                        isOneToOne: false;
-                        referencedRelation: "prj_milestones";
-                        referencedColumns: ["id"];
-                    },
                     {
                         foreignKeyName: "prj_notes_organization_id_fkey";
                         columns: ["organization_id"];
@@ -4407,13 +4410,6 @@ type Database = {
                         isOneToOne: false;
                         referencedRelation: "prj_projects";
                         referencedColumns: ["id"];
-                    },
-                    {
-                        foreignKeyName: "prj_notes_task_id_fkey";
-                        columns: ["task_id"];
-                        isOneToOne: false;
-                        referencedRelation: "prj_tasks";
-                        referencedColumns: ["id"];
                     }
                 ];
             };
@@ -6337,8 +6333,20 @@ interface ProcessingStateEntry {
 type ProcessingState = Partial<Record<LeadGenStageKey, ProcessingStateEntry>>;
 type CompanyProcessingState = ProcessingState;
 type ContactProcessingState = ProcessingState;
-/** @deprecated Use `processingState`. Retained only as a compile-time/read-shape bridge for external tenants. */
-type LegacyPipelineStatus = unknown;
+/**
+ * @deprecated Use `processingState`. Retained only as a compile-time/read-shape bridge for
+ * external tenants.
+ *
+ * `null`, not `unknown`. The DB column is gone and every response returns null, so `unknown` was
+ * describing a value that cannot occur -- it forced a narrow on a field that is always null while
+ * still type-checking a comparison against a stage name that can never match. Narrowing it turns
+ * that dead comparison into a compile error pointing at `processingState`, which is the migration.
+ *
+ * The WRITE path stays permissive on purpose: the update request schemas keep
+ * `pipelineStatus: z.unknown().optional()` so a tenant still sending the old field gets a no-op
+ * rather than a rejected request.
+ */
+type LegacyPipelineStatus = null;
 /**
  * Enrichment data collected for a company from various sources.
  */
@@ -14266,6 +14274,28 @@ interface AgentConstraints {
     timeout?: number;
     maxSessionMemoryKeys?: number;
     maxMemoryTokens?: number;
+    /**
+     * Spend ceilings for the whole turn, checked between iterations against
+     * `ExecutionContext.aiUsageCollector`. Both are unset by default -- `maxIterations` and `timeout`
+     * bound how MANY calls and how LONG, but nothing bounded how much those calls cost, so an agent
+     * that picked an expensive model or a huge context could spend without limit inside a budget it
+     * was technically respecting.
+     *
+     * Enforced only where a collector is injected (every coordinator-run execution). An agent run
+     * without one is unbounded, the same as one that declares no ceiling.
+     *
+     * Note that **sync nested executions share the parent's collector**, so these ceilings cover the
+     * agent and everything it invokes synchronously. That is the behaviour a spend ceiling should
+     * have, but it does mean a parent's ceiling can be reached by a child's spend.
+     */
+    maxCostUsd?: number;
+    maxTotalTokens?: number;
+    /**
+     * How many times the agent may emit a byte-identical plan in a row before the turn is stopped
+     * (default 3, in `processActions`). Raise it for an agent whose job legitimately involves
+     * repeating itself -- polling one endpoint until it reports ready is the case this exists for.
+     */
+    maxIdenticalIterations?: number;
 }
 interface AgentDefinition {
     config: AgentConfig;

package/dist/index.js

@@ -1,2 +1,2 @@
-export { ActivityEventSchema, BuildPlanSnapshotStepSchema, ProspectingBuildTemplateSchema as BuildTemplateSchema, ContractRefResolutionError, CrmStageKeySchema, CrmStateKeySchema, EmailSchema, ExecutionError, ListBuilderStageKeySchema, ProcessingStageStatusSchema, RegistryValidationError, ResourceRegistry, StepType, ToolingError, bindResourceDescriptor, compileBusinessOntologyValidationIndex, concurrentPool, createLeadGenStageValidators, defineContract, defineResource, defineResourceOntology, defineResources, defineSingleStepWorkflow, defineTopology, defineTopologyRelationship, defineWorkflowConfig, deriveActions, diagnosticOutput, integrationInput, isBuiltInReadinessProfile, isZodType, lookupReadinessProfile, parseTopologyNodeRef, registerReadinessProfile, resolveContractRef, runDiagnostic, splitName, topologyRef, topologyRelationship, validateDeclaredSystemInterfaceReadiness, validateResourceGovernance } from './chunk-OT4CHFQJ.js';
+export { ActivityEventSchema, BuildPlanSnapshotStepSchema, ProspectingBuildTemplateSchema as BuildTemplateSchema, ContractRefResolutionError, CrmStageKeySchema, CrmStateKeySchema, EmailSchema, ExecutionError, ListBuilderStageKeySchema, ProcessingStageStatusSchema, RegistryValidationError, ResourceRegistry, StepType, ToolingError, bindResourceDescriptor, compileBusinessOntologyValidationIndex, concurrentPool, createLeadGenStageValidators, defineContract, defineResource, defineResourceOntology, defineResources, defineSingleStepWorkflow, defineTopology, defineTopologyRelationship, defineWorkflowConfig, deriveActions, diagnosticOutput, integrationInput, isBuiltInReadinessProfile, isZodType, lookupReadinessProfile, parseTopologyNodeRef, registerReadinessProfile, resolveContractRef, runDiagnostic, splitName, topologyRef, topologyRelationship, validateDeclaredSystemInterfaceReadiness, validateResourceGovernance } from './chunk-R3J6BEPO.js';
 export { projectDeploymentSpec, projectTopologyRelationships, toSdkResourceDescriptor, withPlatformAgentResourceDescriptor, withPlatformAgentResourceDescriptors, withPlatformIntegrationResourceDescriptor, withPlatformIntegrationResourceDescriptors, withPlatformResourceDescriptor, withPlatformResourceDescriptors } from './chunk-QF2RNYYX.js';

package/dist/node/index.d.ts

@@ -44,15 +44,8 @@ interface KnowledgeNodeInput {
     summary: string;
     body: string;
 }
-interface KnowledgeSearchEntry {
-    id: string;
-    title: string;
-    summary: string;
-    bodyText: string;
-}
 interface CodegenResult {
     bodiesTsx: string;
-    searchIndex: KnowledgeSearchEntry[];
 }
 /**
  * Compiles knowledge nodes into generated file contents.
@@ -71,4 +64,4 @@ interface ResolvedKnowledgeLayout {
 declare function runKnowledgeCodegen(layout: ResolvedKnowledgeLayout): Promise<void>;
 
 export { generateKnowledgeBodies, generateKnowledgeNodes, generateKnowledgeNodesTs, readKnowledgeNodeMdx, runKnowledgeCodegen };
-export type { CodegenResult, GenerateKnowledgeNodesOptions, GenerateKnowledgeNodesResult, KnowledgeCodegenNode, KnowledgeKind, KnowledgeNodeInput, KnowledgeSearchEntry, ResolvedKnowledgeLayout };
+export type { CodegenResult, GenerateKnowledgeNodesOptions, GenerateKnowledgeNodesResult, KnowledgeCodegenNode, KnowledgeKind, KnowledgeNodeInput, ResolvedKnowledgeLayout };

package/dist/node/index.js

@@ -393,9 +393,6 @@ To add a component:
     );
   }
 }
-function stripToPlainText(body) {
-  return body.replace(/^(import|export)\s+.+$/gm, "").replace(/<[A-Z][^>]*>/g, "").replace(/<\/[A-Z][^>]*>/g, "").replace(/^#{1,6}\s+/gm, "").replace(/[*_`~]/g, "").replace(/\[([^\]]+)\]\([^)]+\)/g, "$1").replace(/\n{3,}/g, "\n\n").trim();
-}
 var BODIES_HEADER = [
   "// @generated by generate-knowledge-bodies -- DO NOT EDIT",
   "// Regenerate: pnpm scaffold:sync",
@@ -457,11 +454,10 @@ async function generateKnowledgeBodies(nodes) {
       "> = {}",
       ""
     ].join("\n");
-    return { bodiesTsx: bodiesTsx2, searchIndex: [] };
+    return { bodiesTsx: bodiesTsx2 };
   }
   const nodeComments = [];
   const mapEntries = [];
-  const searchIndex = [];
   for (const node of nodes) {
     if (/^(import|export)\s+/m.test(node.body)) {
       throw new Error(
@@ -475,15 +471,13 @@ async function generateKnowledgeBodies(nodes) {
     });
     const fnBodyCode = String(compiled);
     validateComponents(node.id, fnBodyCode);
-    const bodyText = stripToPlainText(node.body);
-    searchIndex.push({ id: node.id, title: node.title, summary: node.summary, bodyText });
     nodeComments.push(`// Node: ${node.id} (${node.kind})`);
     mapEntries.push(`  '${node.id}': makeKnowledgeComponent(${JSON.stringify(fnBodyCode)})`);
   }
   const mapBlock = `export const KNOWLEDGE_BODIES: Record<string, ComponentType<KnowledgeBodyProps>> = {
 ` + mapEntries.join(",\n") + "\n}\n";
   const bodiesTsx = BODIES_HEADER + FACTORY_BLOCK + MAP_HEADER + (nodeComments.length > 0 ? nodeComments.join("\n") + "\n\n" : "") + mapBlock;
-  return { bodiesTsx, searchIndex };
+  return { bodiesTsx };
 }
 async function runKnowledgeCodegen(layout) {
   let nodes;
@@ -504,14 +498,9 @@ async function runKnowledgeCodegen(layout) {
     });
     nodes = result.nodes;
   }
-  const { bodiesTsx, searchIndex } = await generateKnowledgeBodies(nodes);
+  const { bodiesTsx } = await generateKnowledgeBodies(nodes);
   mkdirSync(layout.generatedDir, { recursive: true });
   writeFileSync(resolve(layout.generatedDir, "knowledge-bodies.tsx"), bodiesTsx, "utf8");
-  writeFileSync(
-    resolve(layout.generatedDir, "knowledge-search-index.json"),
-    JSON.stringify(searchIndex, null, 2) + "\n",
-    "utf8"
-  );
 }
 
 export { generateKnowledgeBodies, generateKnowledgeNodes, generateKnowledgeNodesTs, readKnowledgeNodeMdx, runKnowledgeCodegen };

package/dist/test-utils/index.js

@@ -1,5 +1,5 @@
-import { executeWorkflow } from '../chunk-ZAVFBZHM.js';
-import { validateDeploymentSpec, validateRelationships } from '../chunk-OT4CHFQJ.js';
+import { executeWorkflow } from '../chunk-72ZGICTR.js';
+import { validateDeploymentSpec, validateRelationships } from '../chunk-R3J6BEPO.js';
 import '../chunk-QF2RNYYX.js';
 import { vi } from 'vitest';
 

package/dist/worker/index.d.ts

@@ -14,6 +14,15 @@ interface TokenUsage {
     outputTokens: number;
     cost?: number;
     model?: string;
+    /**
+     * Anthropic excludes cache reads and writes from the wire `input_tokens`, and `AIUsageCollector`
+     * adds them back when it records a call. They are forwarded here so the worker-side collector the
+     * spend ceiling reads folds them in exactly as the parent's does — without them the worker's token
+     * total silently runs below the figure `execution_metrics` persists, and a `maxTotalTokens` ceiling
+     * would be enforced against the smaller number.
+     */
+    cacheReadInputTokens?: number;
+    cacheCreationInputTokens?: number;
 }
 /** Resolved credential returned by platform.getCredential() */
 interface PlatformCredential {

package/dist/worker/index.js

@@ -1,3 +1,3 @@
-export { ListBuilderResultSchema, ListBuilderResultsSchema, PlatformToolError, acqDb, approval, artifacts, classifyPlatformToolError, content, createAdapter, createAnymailfinderAdapter, createApifyAdapter, createAttioAdapter, createCaptionGenerationWorkflow, createCaptureInstagramMetricsWorkflow, createClickUpAdapter, createDropboxAdapter, createGmailAdapter, createGoogleSheetsAdapter, createImageAnalysisWorkflow, createInstagramAdapter, createInstantlyAdapter, createMillionVerifierAdapter, createPublishInstagramWorkflow, createResendAdapter, createSignatureApiAdapter, createStripeAdapter, createTombaAdapter, crm, email, executeWorkflow, execution, generateHmacToken, list, listBuilderWorkflow, llm, notifications, pdf, platform, projects, scheduler, startWorker, storage, toContentMetrics } from '../chunk-ZAVFBZHM.js';
-import '../chunk-OT4CHFQJ.js';
+export { ListBuilderResultSchema, ListBuilderResultsSchema, PlatformToolError, acqDb, approval, artifacts, classifyPlatformToolError, content, createAdapter, createAnymailfinderAdapter, createApifyAdapter, createAttioAdapter, createCaptionGenerationWorkflow, createCaptureInstagramMetricsWorkflow, createClickUpAdapter, createDropboxAdapter, createGmailAdapter, createGoogleSheetsAdapter, createImageAnalysisWorkflow, createInstagramAdapter, createInstantlyAdapter, createMillionVerifierAdapter, createPublishInstagramWorkflow, createResendAdapter, createSignatureApiAdapter, createStripeAdapter, createTombaAdapter, crm, email, executeWorkflow, execution, generateHmacToken, list, listBuilderWorkflow, llm, notifications, pdf, platform, projects, scheduler, startWorker, storage, toContentMetrics } from '../chunk-72ZGICTR.js';
+import '../chunk-R3J6BEPO.js';
 import '../chunk-QF2RNYYX.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevasis/sdk",
-  "version": "1.54.0",
+  "version": "1.56.0",
   "description": "SDK for building Elevasis organization resources",
   "type": "module",
   "bin": {
@@ -63,9 +63,9 @@
     "typescript": "5.9.2",
     "vitest": "^3.2.4",
     "zod": "^4.1.0",
-    "@repo/core": "0.70.0",
-    "@repo/typescript-config": "0.0.0",
-    "@repo/eslint-config": "0.0.0"
+    "@repo/core": "0.72.0",
+    "@repo/eslint-config": "0.0.0",
+    "@repo/typescript-config": "0.0.0"
   },
   "license": "MIT",
   "engines": {

package/reference/_navigation.md

@@ -162,7 +162,7 @@ Package entries indexed: 63.
 | Theme | `packages/ui/src/theme/README.md` | Published theme entry for downstream applications. | (not specified) |
 | Graph | `packages/ui/src/graph/README.md` | Published graph helper and visualization entry. | (not specified) |
 | Theme Presets | `packages/ui/src/theme/presets/README.md` | Published THEME_PRESETS tuple, ThemePresetName union, and ThemePresetEnum Zod enum, defined locally and kept manually aligned with the canonical list in packages/core/src/auth/multi-tenancy/theme-presets.ts. | (not specified) |
-| Knowledge | `packages/ui/src/knowledge/README.md` | Published knowledge browser primitives: Browser, Tree, NodeList, NodeView, SearchBar, MDX provider, and the generated KNOWLEDGE_BODIES map. | (not specified) |
+| Knowledge | `packages/ui/src/knowledge/README.md` | Published knowledge browser primitives: Browser, Tree, NodeList, NodeView, SearchBar, MDX provider, and the KnowledgeBodiesMap type. Machinery only -- each consumer supplies its own compiled corpus via the required knowledgeBodies prop. | (not specified) |
 
 ---
 
@@ -226,9 +226,9 @@ Agent rules indexed: 19.
 | Platform | `rules/platform.md` | Platform conventions -- SDK workflows, agents, deployment, resource registry | Authoring a workflow or agent definition, or registering a resource in the registry. |
 | Deployment | `rules/deployment.md` | Deployment workflow -- check-first, dev vs prod, version bumping, common errors | Before any deploy -- a plain `run deploy` targets production by default. |
 | Content | `rules/content.md` | Building the content System behind the shipped pipeline, item, and distribution routes -- which recipe to read, and the catalog vocabulary that is model-owned rather than coded | Editing anything under `ui/src/routes/content/` -- items, pipelines, distributions, or a review gate. |
-| Execution Model | `rules/execution.md` | Execution model -- timeouts, memory, concurrency, org isolation, runtime constraints | Hitting a timeout, memory ceiling, concurrency limit, or org-isolation question at runtime. |
+| Execution Model | `rules/execution.md` | Execution model -- per-step and agent timeouts, spend ceilings, memory, concurrency, org isolation | Hitting a timeout, memory ceiling, concurrency limit, or org-isolation question at runtime. |
 | Agent Runtime | `rules/agent-runtime.md` | Agent runtime behavior -- iteration response shape, session memory and replay, prose normalization, and why a redeploy is what makes a platform fix live | Debugging an agent turn -- a missing reply, a corrupted one, a session that forgot, or an unenforced schema. |
-| Error Handling | `rules/error-handling.md` | Error handling -- ExecutionError vs PlatformToolError, retry logic, no auto-retry | Writing or debugging a step handler that throws, catches, or retries. |
+| Error Handling | `rules/error-handling.md` | Error handling -- ExecutionError vs PlatformToolError, retry logic, no auto-retry, /api/external error envelope | Writing or debugging a step handler that throws, catches, or retries. |
 | Observability | `rules/observability.md` | Observability -- context.logger API, execution inspection, step-level context | Adding logging to a step handler, or inspecting a past execution. |
 
 ### Orientation

package/reference/_reference-manifest.json

@@ -875,7 +875,7 @@
       "subpath": "./knowledge",
       "kind": "subpath",
       "title": "Knowledge",
-      "description": "Published knowledge browser primitives: Browser, Tree, NodeList, NodeView, SearchBar, MDX provider, and the generated KNOWLEDGE_BODIES map.",
+      "description": "Published knowledge browser primitives: Browser, Tree, NodeList, NodeView, SearchBar, MDX provider, and the KnowledgeBodiesMap type. Machinery only -- each consumer supplies its own compiled corpus via the required knowledgeBodies prop.",
       "group": "Visual",
       "order": 3,
       "sourcePath": "packages/ui/src/knowledge/index.ts",
@@ -948,7 +948,7 @@
     {
       "packageName": "@elevasis/sdk",
       "title": "Execution Model",
-      "description": "Execution model -- timeouts, memory, concurrency, org isolation, runtime constraints",
+      "description": "Execution model -- per-step and agent timeouts, spend ceilings, memory, concurrency, org isolation",
       "group": "Operations",
       "order": 4,
       "loadWhen": "Hitting a timeout, memory ceiling, concurrency limit, or org-isolation question at runtime.",
@@ -968,7 +968,7 @@
     {
       "packageName": "@elevasis/sdk",
       "title": "Error Handling",
-      "description": "Error handling -- ExecutionError vs PlatformToolError, retry logic, no auto-retry",
+      "description": "Error handling -- ExecutionError vs PlatformToolError, retry logic, no auto-retry, /api/external error envelope",
       "group": "Operations",
       "order": 6,
       "loadWhen": "Writing or debugging a step handler that throws, catches, or retries.",

package/reference/packages/core/src/knowledge/README.md

@@ -27,7 +27,7 @@ Pure query layer over the organization graph. Browser-safe (no Node APIs); share
 
 ## JSON envelope
 
-`formatJson` returns `{ path, mount, args, results }` — the same wrapped envelope used by `pnpm exec elevasis knowledge:ls --json` and `pnpm exec elevasis-sdk knowledge:ls --json`.
+`formatJson` returns `{ path, mount, args, results }` — the same wrapped envelope used by `pnpm exec elevasis knowledge:ls --json` and `pnpm exec elevasis-sdk knowledge:ls --json`.
 
 `governs` and `governedBy` accept either bare or graph-namespaced ids (`knowledge.foo` or `knowledge:knowledge.foo`).