@namzu/sdk 27.0.0 → 28.0.0

package/dist/public-tools.d.ts

@@ -7,8 +7,15 @@ export { ReadFileTool } from './tools/builtins/read-file.js';
 export { WriteFileTool } from './tools/builtins/write-file.js';
 export { EditTool } from './tools/builtins/edit.js';
 export { BashTool } from './tools/builtins/bash.js';
+export { LSP_TOOL_NAME, LspTool, getCodeNavigationTools } from './tools/builtins/lsp.js';
 export { GlobTool } from './tools/builtins/glob.js';
 export { GrepTool } from './tools/builtins/grep.js';
+export { JobTool } from './tools/builtins/job.js';
+export { SKILL_TOOL_NAME, SkillTool, parseAllowedTools } from './tools/builtins/skill.js';
+export { WEB_FETCH_TOOL_NAME, WEB_SEARCH_TOOL_NAME, WebFetchTool, WebSearchTool, } from './tools/builtins/web.js';
+export { WEB_GUIDANCE_CONTRIBUTION_ID, webGuidanceContribution, } from './tools/builtins/web-guidance.js';
+export { RUN_CODE_TOOL_NAME, buildRunCodeTool, } from './tools/builtins/run-code.js';
+export type { RunCodeToolOptions } from './tools/builtins/run-code.js';
 export { LsTool } from './tools/builtins/ls.js';
 export { SearchToolsTool } from './tools/builtins/search-tools.js';
 export { VerifyOutputsTool } from './tools/builtins/verify-outputs.js';
@@ -20,5 +27,5 @@ export { buildMemoryTools } from './tools/memory/index.js';
 export { buildCoordinatorTools } from './tools/coordinator/index.js';
 export { buildAgentTool, type AgentToolOptions } from './tools/coordinator/agent.js';
 export { createRAGTool } from './rag/index.js';
-export { allConnectorTools, connectorInstanceToTools, connectorMethodToTool, ConnectorToolRouter, createConnectorExecuteTool, createConnectorListTool, createConnectorRouterTool, createConnectorTools, } from './bridge/tools/connector/index.js';
+export { allConnectorTools, connectorInstanceToTools, connectorMethodToTool, ConnectorToolRouter, createConnectorExecuteTool, createConnectorListTool, createConnectorRouterTool, createConnectorTools, } from './connector/tools/index.js';
 //# sourceMappingURL=public-tools.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"public-tools.d.ts","sourceRoot":"","sources":["../src/public-tools.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAIlD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAG7E,OAAO,EAAE,2BAA2B,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAC1F,YAAY,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AAItE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAA;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAA;AACtE,OAAO,EACN,0BAA0B,EAC1B,2BAA2B,GAC3B,MAAM,sCAAsC,CAAA;AAC7C,OAAO,EACN,sBAAsB,EACtB,qBAAqB,GACrB,MAAM,kCAAkC,CAAA;AAIzC,OAAO,EACN,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,mBAAmB,GACnB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AACpE,OAAO,EAAE,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAIpF,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAI9C,OAAO,EACN,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,0BAA0B,EAC1B,uBAAuB,EACvB,yBAAyB,EACzB,oBAAoB,GACpB,MAAM,mCAAmC,CAAA"}
+{"version":3,"file":"public-tools.d.ts","sourceRoot":"","sources":["../src/public-tools.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAIlD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAG7E,OAAO,EAAE,2BAA2B,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAC1F,YAAY,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AAItE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AACxF,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAKnD,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AAKjD,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAMzF,OAAO,EACN,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,aAAa,GACb,MAAM,yBAAyB,CAAA;AAKhC,OAAO,EACN,4BAA4B,EAC5B,uBAAuB,GACvB,MAAM,kCAAkC,CAAA;AAMzC,OAAO,EACN,kBAAkB,EAClB,gBAAgB,GAChB,MAAM,8BAA8B,CAAA;AACrC,YAAY,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAA;AACtE,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAA;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAA;AACtE,OAAO,EACN,0BAA0B,EAC1B,2BAA2B,GAC3B,MAAM,sCAAsC,CAAA;AAC7C,OAAO,EACN,sBAAsB,EACtB,qBAAqB,GACrB,MAAM,kCAAkC,CAAA;AAIzC,OAAO,EACN,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,mBAAmB,GACnB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AACpE,OAAO,EAAE,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAIpF,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAI9C,OAAO,EACN,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,0BAA0B,EAC1B,uBAAuB,EACvB,yBAAyB,EACzB,oBAAoB,GACpB,MAAM,4BAA4B,CAAA"}

package/dist/public-tools.js

@@ -23,8 +23,36 @@ export { ReadFileTool } from './tools/builtins/read-file.js';
 export { WriteFileTool } from './tools/builtins/write-file.js';
 export { EditTool } from './tools/builtins/edit.js';
 export { BashTool } from './tools/builtins/bash.js';
+export { LSP_TOOL_NAME, LspTool, getCodeNavigationTools } from './tools/builtins/lsp.js';
 export { GlobTool } from './tools/builtins/glob.js';
 export { GrepTool } from './tools/builtins/grep.js';
+// Reads, lists and stops what `bash run_in_background` starts. Ships in
+// the default builtin set alongside bash, because the two are one
+// capability: an id with nothing that reads it is the unbacked suggestion
+// that was removed from bash's schema.
+export { JobTool } from './tools/builtins/job.js';
+// Loads a skill's instructions, and adopts the tool scope it declares.
+// NOT in the default builtin set: a run with no skills has nothing for it
+// to do, and offering a tool that can only refuse is worse than not
+// offering it. Hosts register it alongside a skills registry.
+export { SKILL_TOOL_NAME, SkillTool, parseAllowedTools } from './tools/builtins/skill.js';
+// Both declare `category: 'network'`, which is what the authorization
+// presets branch on. NOT in the default builtin set: a run with no web
+// provider has nothing for them to do, and only the `unattended` preset --
+// the one requiring the sandbox to confine the network -- auto-approves
+// them.
+export { WEB_FETCH_TOOL_NAME, WEB_SEARCH_TOOL_NAME, WebFetchTool, WebSearchTool, } from './tools/builtins/web.js';
+// The paragraph neither tool owns: how to use the two together, and what a
+// fetched page is. Registered with the prompt contribution registry only
+// when the tools are — guidance about tools a run does not have spends the
+// cached prefix telling the model to cite a search it cannot run.
+export { WEB_GUIDANCE_CONTRIBUTION_ID, webGuidanceContribution, } from './tools/builtins/web-guidance.js';
+// A program the model wrote, calling this run's own tools in a loop. Opt-in
+// and NOT in the default builtin set: a run that does not need
+// model-authored control flow should not have a way to execute
+// model-authored text, and "the tool was there so it got used" is not a
+// threat model.
+export { RUN_CODE_TOOL_NAME, buildRunCodeTool, } from './tools/builtins/run-code.js';
 export { LsTool } from './tools/builtins/ls.js';
 export { SearchToolsTool } from './tools/builtins/search-tools.js';
 export { VerifyOutputsTool } from './tools/builtins/verify-outputs.js';
@@ -39,5 +67,5 @@ export { buildAgentTool } from './tools/coordinator/agent.js';
 // ─── RAG tool builder ────────────────────────────────────────────────────
 export { createRAGTool } from './rag/index.js';
 // ─── Connector tool bridge ───────────────────────────────────────────────
-export { allConnectorTools, connectorInstanceToTools, connectorMethodToTool, ConnectorToolRouter, createConnectorExecuteTool, createConnectorListTool, createConnectorRouterTool, createConnectorTools, } from './bridge/tools/connector/index.js';
+export { allConnectorTools, connectorInstanceToTools, connectorMethodToTool, ConnectorToolRouter, createConnectorExecuteTool, createConnectorListTool, createConnectorRouterTool, createConnectorTools, } from './connector/tools/index.js';
 //# sourceMappingURL=public-tools.js.map

package/dist/public-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"public-tools.js","sourceRoot":"","sources":["../src/public-tools.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,EAAE;AACF,2EAA2E;AAC3E,6EAA6E;AAC7E,EAAE;AACF,wEAAwE;AACxE,wEAAwE;AACxE,yEAAyE;AACzE,EAAE;AACF,+CAA+C;AAE/C,4EAA4E;AAE5E,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAClD,2EAA2E;AAC3E,0EAA0E;AAC1E,yBAAyB;AACzB,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAC7E,2EAA2E;AAC3E,yEAAyE;AACzE,OAAO,EAAE,2BAA2B,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAG1F,4EAA4E;AAE5E,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAA;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAA;AACtE,OAAO,EACN,0BAA0B,EAC1B,2BAA2B,GAC3B,MAAM,sCAAsC,CAAA;AAC7C,OAAO,EACN,sBAAsB,EACtB,qBAAqB,GACrB,MAAM,kCAAkC,CAAA;AAEzC,4EAA4E;AAE5E,OAAO,EACN,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,mBAAmB,GACnB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AACpE,OAAO,EAAE,cAAc,EAAyB,MAAM,8BAA8B,CAAA;AAEpF,4EAA4E;AAE5E,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAE9C,4EAA4E;AAE5E,OAAO,EACN,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,0BAA0B,EAC1B,uBAAuB,EACvB,yBAAyB,EACzB,oBAAoB,GACpB,MAAM,mCAAmC,CAAA"}
+{"version":3,"file":"public-tools.js","sourceRoot":"","sources":["../src/public-tools.ts"],"names":[],"mappings":"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"}

package/dist/public-types.d.ts

@@ -1,6 +1,7 @@
 export type * from './types/ids/index.js';
 export type * from './types/message/index.js';
 export type * from './types/common/index.js';
+export type { CoalesceOptions } from './streaming/coalesce.js';
 export type * from './types/bidi/index.js';
 export type * from './types/tool/index.js';
 export type * from './directory/types.js';
@@ -30,7 +31,7 @@ export type * from './types/sandbox/index.js';
 export type * from './types/structured-output/index.js';
 export type * from './types/invocation/index.js';
 export type * from './types/computer-use/index.js';
-export type * from './types/verification/index.js';
+export type * from './types/authorization/index.js';
 export type * from './types/bus/index.js';
 export type * from './types/probe/index.js';
 export type * from './types/doctor/index.js';
@@ -44,9 +45,10 @@ export type { VendorRates } from './pricing/index.js';
 export type { PricingSubject } from './manager/run/persistence.js';
 export type { FrontmatterValue, ParsedFrontmatter } from './utils/frontmatter.js';
 export type { Logger } from './utils/logger.js';
+export type { LevelFilter, LogRecord, LogSink, LogSinkCounters, Resource, Severity, } from './utils/log/index.js';
 export type { ShellCompressOptions, ShellCompressResult } from './utils/shell-compress.js';
 export type { QueryParams } from './runtime/query/index.js';
-export type { ContextCacheConfig, PromptCacheInput } from './runtime/query/context-cache.js';
+export type { PromptCacheConfig, PromptCacheInput } from './runtime/query/prompt-cache.js';
 export type { LimitCheckResult, LimitCheckerState, RunReporter } from './run/index.js';
 export type { AgentIdentity, DefineAgentOptions, Disposable, RunAgentOptions, RunAgentResult, } from './agents/index.js';
 export type { ActivityEvent, ActivityEventListener, DiskMemoryStoreConfig, DiskTaskStoreConfig, Identifiable, Timestamped, } from './store/index.js';
@@ -58,13 +60,28 @@ export type { AdvisoryToolsOptions } from './tools/advisory/index.js';
 export type { CoordinatorToolsOptions, TaskLaunchedCallback } from './tools/coordinator/index.js';
 export type { RegisterSharedRunPlanInput, SharedRunWorkspaceConfig, } from './session/workspace/index.js';
 export type { ConnectorManagerConfig, EnvironmentConnectorManagerConfig, EnvironmentConnectorSetup, HybridExecutionContextOptions, LocalExecutionContextOptions, MCPServerResourceProvider, MCPServerPromptProvider, MCPServerToolProvider, RemoteExecutionContextOptions, TenantConnectorManagerConfig, } from './connector/index.js';
-export type { ConnectorRouterInput, ConnectorToolConfig, ConnectorToolRouterConfig, ConnectorToolStrategy, } from './bridge/tools/connector/index.js';
+export type { ConnectorRouterInput, ConnectorToolConfig, ConnectorToolRouterConfig, ConnectorToolStrategy, } from './connector/tools/index.js';
 export type { CreateRunFromA2A } from './bridge/a2a/index.js';
 export type { MappedStreamEvent } from './bridge/sse/index.js';
 export type { AgentBusConfig } from './bus/index.js';
-export type { ToolCallContext } from './verification/index.js';
+export type { ToolCallContext } from './authorization/index.js';
+export type { PermissionPreset } from './authorization/index.js';
 export type { DiskSessionStoreConfig, LinkageView } from './store/session/index.js';
 export type { ContextReducer, ContextReduction, ContextReductionReason, SlidingWindowOptions, ConversationManager, CompactionStrategy, DanglingResult, FileAction, FileSlot, PlanSlot, ToolResultSlot, WorkingState, } from './compaction/index.js';
 export type * from './eval/index.js';
 export type * from './types/guardrail/index.js';
+export type { HostCommandContext, HostCommandDescriptor, HostCommandOutcome, HostCommandRow, SerializableHostCommand, } from './types/command/index.js';
+export type { TopicState } from './types/topic/state.js';
+export type { ObjectiveAdvance, ObjectiveAdvanceResult, ObjectiveBlock, ObjectivePhase, ObjectiveRefusal, ObjectiveRoundVerdict, TopicObjective, } from './types/topic/objective.js';
+export type { CreateObjectiveParams, DiskTopicObjectiveStoreConfig, TopicObjectiveStore, } from './store/topic/objective.js';
+export type { AdvanceObjectiveParams, DriveObjectiveParams, } from './manager/topic/objective.js';
+export type { AgentHandle, AgentHandleOptions, AgentHandleStatus } from './agents/handle.js';
+export type { CredentialDescription, CredentialProvider, CredentialRef as CredentialName, ResolvedCredential, } from './vault/CredentialProvider.js';
+export type { ApprovalPolicy, ApprovalPolicyChange, ApprovalPolicyChangedEvent, RunApprovalPolicy, } from './types/hitl/policy.js';
+export type { PromptContribution, PromptContributionContext, PromptPlacement, } from './prompt/index.js';
+export type { GuardedFetchConfig, WebFetchProvider, WebFetchRefusalReason, WebFetchRequest, WebFetchResult, WebSearchHit, WebSearchProvider, WebSearchRequest, WebSearchResult, } from './connector/web/index.js';
+export type { AttachmentStore, StoredAttachment, StoredBytes, } from './store/attachment/index.js';
+export type { ReadModel, RunStatusReadModelOptions, RunStatusState, } from './read-model/index.js';
+export type { RunQueryOptions, ShedPass } from './run-query/index.js';
+export type { OpenTerminalOptions, PtyLoader, PtyModule, PtyProcess, TerminalSession, TerminalSize, } from './sandbox/terminal.js';
 //# sourceMappingURL=public-types.d.ts.map

package/dist/public-types.d.ts.map

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

package/dist/rag/rag-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rag-tool.d.ts","sourceRoot":"","sources":["../../src/rag/rag-tool.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAS1D,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa;;;;GAoDlD"}
+{"version":3,"file":"rag-tool.d.ts","sourceRoot":"","sources":["../../src/rag/rag-tool.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAU1D,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa;;;;GAsDlD"}

package/dist/rag/rag-tool.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { defineTool } from '../tools/defineTool.js';
+import { asKnowledgeBaseId } from '../utils/id.js';
 import { assembleRAGContext } from './context-assembler.js';
 const ragInputSchema = z.object({
     query: z.string().min(1).describe('The search query to find relevant knowledge'),
@@ -17,7 +18,9 @@ export function createRAGTool(config) {
         destructive: false,
         concurrencySafe: true,
         async execute(input) {
-            const kbId = input.knowledge_base_id ?? config.defaultKnowledgeBaseId;
+            const kbId = (input.knowledge_base_id === undefined
+                ? undefined
+                : asKnowledgeBaseId(input.knowledge_base_id)) ?? config.defaultKnowledgeBaseId;
             const kb = kbId
                 ? config.knowledgeBases.get(kbId)
                 : config.knowledgeBases.values().next().value;

package/dist/rag/rag-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"rag-tool.js","sourceRoot":"","sources":["../../src/rag/rag-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAGnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAE3D,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IAChF,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IAC9F,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;CAC3F,CAAC,CAAA;AAEF,MAAM,UAAU,aAAa,CAAC,MAAqB;IAClD,OAAO,UAAU,CAAC;QACjB,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACV,6KAA6K;QAC9K,WAAW,EAAE,cAAc;QAC3B,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE,CAAC,gBAAgB,CAAC;QAC/B,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,KAAK;QAClB,eAAe,EAAE,IAAI;QAErB,KAAK,CAAC,OAAO,CAAC,KAAK;YAClB,MAAM,IAAI,GACR,KAAK,CAAC,iBAAiD,IAAI,MAAM,CAAC,sBAAsB,CAAA;YAC1F,MAAM,EAAE,GAAG,IAAI;gBACd,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC;gBACjC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAA;YAE9C,IAAI,CAAC,EAAE,EAAE,CAAC;gBACT,OAAO;oBACN,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,EAAE;oBACV,KAAK,EAAE,6BAA6B,IAAI,IAAI,iBAAiB,EAAE;iBAC/D,CAAA;YACF,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC;gBAC7B,IAAI,EAAE,KAAK,CAAC,KAAK;gBACjB,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,IAAI,CAAC,EAAE;aACjD,CAAC,CAAA;YAEF,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAChC,OAAO;oBACN,OAAO,EAAE,IAAI;oBACb,MAAM,EAAE,qEAAqE;iBAC7E,CAAA;YACF,CAAC;YAED,MAAM,OAAO,GAAG,kBAAkB,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,aAAa,CAAC,CAAA;YAEvE,OAAO;gBACN,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,OAAO,CAAC,OAAO;gBACvB,IAAI,EAAE;oBACL,OAAO,EAAE,OAAO,CAAC,OAAO;oBACxB,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,UAAU,EAAE,MAAM,CAAC,UAAU;iBAC7B;aACD,CAAA;QACF,CAAC;KACD,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"rag-tool.js","sourceRoot":"","sources":["../../src/rag/rag-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAEnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAE3D,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IAChF,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IAC9F,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;CAC3F,CAAC,CAAA;AAEF,MAAM,UAAU,aAAa,CAAC,MAAqB;IAClD,OAAO,UAAU,CAAC;QACjB,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACV,6KAA6K;QAC9K,WAAW,EAAE,cAAc;QAC3B,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE,CAAC,gBAAgB,CAAC;QAC/B,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,KAAK;QAClB,eAAe,EAAE,IAAI;QAErB,KAAK,CAAC,OAAO,CAAC,KAAK;YAClB,MAAM,IAAI,GACT,CAAC,KAAK,CAAC,iBAAiB,KAAK,SAAS;gBACrC,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,IAAI,MAAM,CAAC,sBAAsB,CAAA;YAChF,MAAM,EAAE,GAAG,IAAI;gBACd,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC;gBACjC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAA;YAE9C,IAAI,CAAC,EAAE,EAAE,CAAC;gBACT,OAAO;oBACN,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,EAAE;oBACV,KAAK,EAAE,6BAA6B,IAAI,IAAI,iBAAiB,EAAE;iBAC/D,CAAA;YACF,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC;gBAC7B,IAAI,EAAE,KAAK,CAAC,KAAK;gBACjB,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,IAAI,CAAC,EAAE;aACjD,CAAC,CAAA;YAEF,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAChC,OAAO;oBACN,OAAO,EAAE,IAAI;oBACb,MAAM,EAAE,qEAAqE;iBAC7E,CAAA;YACF,CAAC;YAED,MAAM,OAAO,GAAG,kBAAkB,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,aAAa,CAAC,CAAA;YAEvE,OAAO;gBACN,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,OAAO,CAAC,OAAO;gBACvB,IAAI,EAAE;oBACL,OAAO,EAAE,OAAO,CAAC,OAAO;oBACxB,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,UAAU,EAAE,MAAM,CAAC,UAAU;iBAC7B;aACD,CAAA;QACF,CAAC;KACD,CAAC,CAAA;AACH,CAAC"}

package/dist/read-model/index.d.ts

@@ -0,0 +1,5 @@
+export { DuplicateEventError, EventGapError, ReadModelCollisionError, ReadModelRegistry, UnknownReadModelError, } from './registry.js';
+export type { ReadModel } from './registry.js';
+export { RUN_STATUS_READ_MODEL_ID, createRunStatusReadModel } from './run-status.js';
+export type { RunStatusReadModelOptions, RunStatusState } from './run-status.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/read-model/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/read-model/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACN,mBAAmB,EACnB,aAAa,EACb,uBAAuB,EACvB,iBAAiB,EACjB,qBAAqB,GACrB,MAAM,eAAe,CAAA;AACtB,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAA;AACpF,YAAY,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/read-model/index.js

@@ -0,0 +1,7 @@
+// A derived value maintained one event at a time. The registry's refusals
+// are what make "incremental" a property rather than a hope: a duplicate
+// double-counts, and a gap produces a state that looks complete and
+// describes a log the registry never saw.
+export { DuplicateEventError, EventGapError, ReadModelCollisionError, ReadModelRegistry, UnknownReadModelError, } from './registry.js';
+export { RUN_STATUS_READ_MODEL_ID, createRunStatusReadModel } from './run-status.js';
+//# sourceMappingURL=index.js.map

package/dist/read-model/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/read-model/index.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,yEAAyE;AACzE,oEAAoE;AACpE,0CAA0C;AAC1C,OAAO,EACN,mBAAmB,EACnB,aAAa,EACb,uBAAuB,EACvB,iBAAiB,EACjB,qBAAqB,GACrB,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/read-model/registry.d.ts

@@ -0,0 +1,112 @@
+import type { PersistedRunEvent } from '../types/run/index.js';
+/**
+ * A derived value maintained incrementally from the run's event log.
+ *
+ * Everything derived from a run was computed by scanning what was in hand
+ * at the moment somebody asked — `deriveRunStatus` takes a status and a
+ * park and answers about that instant. That works while the whole run fits
+ * in memory and stops working the moment it does not: a caller wanting the
+ * status of a run whose history has been compacted, or of a run in another
+ * process, has to load the log and fold it, and every caller folds it
+ * slightly differently.
+ *
+ * A read model is that fold, written once and advanced one event at a time.
+ * The registry below is what makes "advanced one event at a time" a
+ * property rather than a hope: it refuses a duplicate and refuses a gap, so
+ * a projection is either correct or absent, never quietly built on a log it
+ * did not fully see.
+ */
+export interface ReadModel<TState> {
+    /** Stable, and how a caller asks for this projection's state. */
+    readonly id: string;
+    /** The value before any event. Called once per registry. */
+    initial(): TState;
+    /**
+     * PURE. Same state plus same event must give the same result, every
+     * time and in any process.
+     *
+     * Returning the SAME object when an event changes nothing is expected
+     * and cheap; the registry does not compare, and a model that allocated
+     * a fresh state per event would still be correct, only wasteful.
+     */
+    apply(state: TState, event: PersistedRunEvent): TState;
+}
+/** An event the registry has already folded in. */
+export declare class DuplicateEventError extends Error {
+    readonly details: {
+        seq: number;
+        lastSeq: number;
+    };
+    constructor(details: {
+        seq: number;
+        lastSeq: number;
+    });
+}
+/** An event that skips one the registry never saw. */
+export declare class EventGapError extends Error {
+    readonly details: {
+        seq: number;
+        expected: number;
+    };
+    constructor(details: {
+        seq: number;
+        expected: number;
+    });
+}
+/** A projection nobody registered. */
+export declare class UnknownReadModelError extends Error {
+    readonly details: {
+        id: string;
+    };
+    constructor(details: {
+        id: string;
+    });
+}
+/** Two models claiming one id. */
+export declare class ReadModelCollisionError extends Error {
+    readonly details: {
+        id: string;
+    };
+    constructor(details: {
+        id: string;
+    });
+}
+/**
+ * Every projection of one run, advanced together.
+ *
+ * Together, and that is the design: a registry per run rather than per
+ * model, so `lastSeq` is one number and a caller reading two projections
+ * cannot be handed states derived from different prefixes of the same log.
+ */
+export declare class ReadModelRegistry {
+    private readonly models;
+    private readonly states;
+    private seq;
+    /** The seq this registry has folded up to. `0` before any event. */
+    get lastSeq(): number;
+    register<TState>(model: ReadModel<TState>): void;
+    /**
+     * Fold one event into every projection.
+     *
+     * REFUSES a duplicate and REFUSES a gap. Both are silent corruptions
+     * otherwise: a duplicate double-counts anything a model accumulates, and
+     * a gap produces a state that looks complete and describes a log the
+     * registry never saw. A caller that legitimately has to skip ahead
+     * rebuilds with {@link replay} instead, which is honest about starting
+     * over.
+     */
+    apply(event: PersistedRunEvent): void;
+    /**
+     * Throw away every state and fold the whole log again.
+     *
+     * The honest alternative to accepting a gap. A caller that has lost its
+     * place, or that just registered a model into a running registry, gets a
+     * correct answer by paying for the whole log rather than a plausible one
+     * by pretending it did not miss anything.
+     */
+    replay(events: readonly PersistedRunEvent[]): void;
+    /** The projection's state, or throw for an id nobody registered. */
+    get<TState>(id: string): TState;
+    has(id: string): boolean;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/read-model/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/read-model/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAE9D;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,SAAS,CAAC,MAAM;IAChC,iEAAiE;IACjE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,4DAA4D;IAC5D,OAAO,IAAI,MAAM,CAAA;IACjB;;;;;;;OAOG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAAA;CACtD;AAED,mDAAmD;AACnD,qBAAa,mBAAoB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;gBAEtC,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CAKrD;AAED,sDAAsD;AACtD,qBAAa,aAAc,SAAQ,KAAK;IACvC,QAAQ,CAAC,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;gBAEvC,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;CAOtD;AAED,sCAAsC;AACtC,qBAAa,qBAAsB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;gBAEpB,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE;CAKnC;AAED,kCAAkC;AAClC,qBAAa,uBAAwB,SAAQ,KAAK;IACjD,QAAQ,CAAC,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;gBAEpB,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE;CAKnC;AAED;;;;;;GAMG;AACH,qBAAa,iBAAiB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,GAAG,CAAI;IAEf,oEAAoE;IACpE,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI;IAMhD;;;;;;;;;OASG;IACH,KAAK,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAarC;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,GAAG,IAAI;IAMlD,oEAAoE;IACpE,GAAG,CAAC,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM;IAK/B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAGxB"}

package/dist/read-model/registry.js

@@ -0,0 +1,105 @@
+/** An event the registry has already folded in. */
+export class DuplicateEventError extends Error {
+    details;
+    constructor(details) {
+        super(`Event seq=${details.seq} was already applied (the registry is at ${details.lastSeq}).`);
+        this.name = 'DuplicateEventError';
+        this.details = details;
+    }
+}
+/** An event that skips one the registry never saw. */
+export class EventGapError extends Error {
+    details;
+    constructor(details) {
+        super(`Event seq=${details.seq} arrived while the registry expected ${details.expected}; a projection built across a gap is wrong in a way nothing reports.`);
+        this.name = 'EventGapError';
+        this.details = details;
+    }
+}
+/** A projection nobody registered. */
+export class UnknownReadModelError extends Error {
+    details;
+    constructor(details) {
+        super(`No read model registered as "${details.id}".`);
+        this.name = 'UnknownReadModelError';
+        this.details = details;
+    }
+}
+/** Two models claiming one id. */
+export class ReadModelCollisionError extends Error {
+    details;
+    constructor(details) {
+        super(`A read model with id "${details.id}" is already registered.`);
+        this.name = 'ReadModelCollisionError';
+        this.details = details;
+    }
+}
+/**
+ * Every projection of one run, advanced together.
+ *
+ * Together, and that is the design: a registry per run rather than per
+ * model, so `lastSeq` is one number and a caller reading two projections
+ * cannot be handed states derived from different prefixes of the same log.
+ */
+export class ReadModelRegistry {
+    models = new Map();
+    states = new Map();
+    seq = 0;
+    /** The seq this registry has folded up to. `0` before any event. */
+    get lastSeq() {
+        return this.seq;
+    }
+    register(model) {
+        if (this.models.has(model.id))
+            throw new ReadModelCollisionError({ id: model.id });
+        this.models.set(model.id, model);
+        this.states.set(model.id, model.initial());
+    }
+    /**
+     * Fold one event into every projection.
+     *
+     * REFUSES a duplicate and REFUSES a gap. Both are silent corruptions
+     * otherwise: a duplicate double-counts anything a model accumulates, and
+     * a gap produces a state that looks complete and describes a log the
+     * registry never saw. A caller that legitimately has to skip ahead
+     * rebuilds with {@link replay} instead, which is honest about starting
+     * over.
+     */
+    apply(event) {
+        if (event.seq <= this.seq) {
+            throw new DuplicateEventError({ seq: event.seq, lastSeq: this.seq });
+        }
+        if (event.seq !== this.seq + 1) {
+            throw new EventGapError({ seq: event.seq, expected: this.seq + 1 });
+        }
+        for (const [id, model] of this.models) {
+            this.states.set(id, model.apply(this.states.get(id), event));
+        }
+        this.seq = event.seq;
+    }
+    /**
+     * Throw away every state and fold the whole log again.
+     *
+     * The honest alternative to accepting a gap. A caller that has lost its
+     * place, or that just registered a model into a running registry, gets a
+     * correct answer by paying for the whole log rather than a plausible one
+     * by pretending it did not miss anything.
+     */
+    replay(events) {
+        for (const [id, model] of this.models)
+            this.states.set(id, model.initial());
+        this.seq = 0;
+        for (const event of events)
+            this.apply(event);
+    }
+    /** The projection's state, or throw for an id nobody registered. */
+    get(id) {
+        if (!this.models.has(id))
+            throw new UnknownReadModelError({ id });
+        return this.states.get(id);
+    }
+    has(id) {
+        return this.models.has(id);
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/read-model/registry.js.map

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

package/dist/read-model/run-status.d.ts

@@ -0,0 +1,43 @@
+import type { RunExecutionStatus } from '../types/common/index.js';
+import type { PendingDecision } from '../types/hitl/index.js';
+import type { RunStatus } from '../types/run/index.js';
+import type { ReadModel } from './registry.js';
+/**
+ * A run's session-layer status, maintained from its own event log.
+ *
+ * `deriveRunStatus` answers about an instant: hand it a status and a park
+ * and it projects them. Getting those two inputs meant holding the run
+ * record and the park store, which a caller reading a finished run's
+ * history — or a run in another process — does not have. This derives both
+ * from the events the run already emits, so the projection needs the log
+ * and nothing else.
+ *
+ * The instant-projector is still what answers; this only feeds it. Two
+ * implementations of the same rule would be two chances to disagree about
+ * what `awaiting_hitl_resolution` means, and the disagreement would show up
+ * as a run that reads differently depending on which surface asked.
+ */
+export declare const RUN_STATUS_READ_MODEL_ID = "namzu.run.status";
+export interface RunStatusState {
+    readonly execution: RunExecutionStatus;
+    /** The outstanding park, if the log says there is one. */
+    readonly park?: PendingDecision;
+    /** `deriveRunStatus` at the moment the last event was folded in. */
+    readonly status: RunStatus;
+}
+/**
+ * `now` is injected, and the reason is subtle enough to state.
+ *
+ * `awaiting_hitl` becomes `awaiting_hitl_resolution` when a deadline
+ * passes, and a deadline passes without any event being emitted. So the
+ * state a fold produces is the status AS OF the last event — which is the
+ * honest thing for a projection to hold, since nothing woke it up at the
+ * deadline. A caller that needs the answer right now re-projects with
+ * `deriveRunStatus(state)` and its own clock; the field here is what the
+ * log alone can say.
+ */
+export interface RunStatusReadModelOptions {
+    readonly now?: () => number;
+}
+export declare function createRunStatusReadModel(options?: RunStatusReadModelOptions): ReadModel<RunStatusState>;
+//# sourceMappingURL=run-status.d.ts.map

package/dist/read-model/run-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-status.d.ts","sourceRoot":"","sources":["../../src/read-model/run-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAE7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE9C;;;;;;;;;;;;;;GAcG;AAEH,eAAO,MAAM,wBAAwB,qBAAqB,CAAA;AAE1D,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAA;IACtC,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,CAAC,EAAE,eAAe,CAAA;IAC/B,oEAAoE;IACpE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;CAC1B;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,yBAAyB;IACzC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CAC3B;AAED,wBAAgB,wBAAwB,CACvC,OAAO,GAAE,yBAA8B,GACrC,SAAS,CAAC,cAAc,CAAC,CA6E3B"}

package/dist/read-model/run-status.js

@@ -0,0 +1,89 @@
+import { deriveRunStatus } from '../types/run/derive-status.js';
+/**
+ * A run's session-layer status, maintained from its own event log.
+ *
+ * `deriveRunStatus` answers about an instant: hand it a status and a park
+ * and it projects them. Getting those two inputs meant holding the run
+ * record and the park store, which a caller reading a finished run's
+ * history — or a run in another process — does not have. This derives both
+ * from the events the run already emits, so the projection needs the log
+ * and nothing else.
+ *
+ * The instant-projector is still what answers; this only feeds it. Two
+ * implementations of the same rule would be two chances to disagree about
+ * what `awaiting_hitl_resolution` means, and the disagreement would show up
+ * as a run that reads differently depending on which surface asked.
+ */
+export const RUN_STATUS_READ_MODEL_ID = 'namzu.run.status';
+export function createRunStatusReadModel(options = {}) {
+    const now = options.now ?? Date.now;
+    const project = (execution, park) => ({
+        execution,
+        ...(park ? { park } : {}),
+        status: deriveRunStatus({ status: execution, ...(park ? { park } : {}), now: now() }),
+    });
+    return {
+        id: RUN_STATUS_READ_MODEL_ID,
+        // `idle`, not `pending`. A run whose log is empty has not been queued
+        // by anything this projection saw, and `queued` is a claim about a
+        // decision somebody made.
+        initial: () => project('idle'),
+        apply(state, event) {
+            switch (event.type) {
+                case 'run_started':
+                    return project('running');
+                case 'run_completed':
+                    return project('completed');
+                case 'run_failed':
+                    return project('failed');
+                case 'checkpoint_created':
+                case 'run_paused':
+                    // A pause is not a park. The park below is what carries a
+                    // deadline and therefore what separates "waiting" from
+                    // "waited too long"; a pause with no park is a run that
+                    // stopped for a reason this projection cannot name, and
+                    // inventing `awaiting_hitl` for it would report a human as
+                    // owing an answer nobody asked them for.
+                    //
+                    // These two cases are BEHAVIOURALLY identical to the
+                    // `default` below and are kept anyway, which a mutation
+                    // correctly reports as surviving. They are here because
+                    // these are the two events a reader most expects to change
+                    // the status; falling into a silent `default` would leave
+                    // the next person to ask deducing the decision from its
+                    // absence, and the last time somebody deduced it they
+                    // deduced wrong.
+                    return state;
+                case 'tool_review_requested':
+                case 'user_question_asked':
+                    // A park, as the log records one. `deadlineAt` is absent
+                    // here because these events do not carry it — so a run
+                    // waiting on a review reads `awaiting_hitl` and never
+                    // `awaiting_hitl_resolution`, which is correct: with no
+                    // deadline in the log there is nothing that could expire.
+                    return project(state.execution === 'idle' ? 'running' : state.execution, {
+                        // The shape `deriveRunStatus` actually reads: `resolvedAt`
+                        // absent means outstanding, and `deadlineAt` absent means
+                        // nothing can expire. `request` is carried because the
+                        // type requires it, and is the event itself — the log IS
+                        // what the run parked on, so synthesising a different
+                        // object would be inventing a request nobody made.
+                        request: event,
+                        parkedAt: event.timestamp,
+                    });
+                case 'tool_review_completed':
+                case 'user_question_answered':
+                case 'run_resuming':
+                    // Answered. Dropping the park is what moves the run back to
+                    // `running`, and it has to happen on the ANSWER rather than
+                    // on the next tool call — a run that stayed `awaiting_hitl`
+                    // until it happened to do something else would show a human
+                    // as owed an answer they had already given.
+                    return project(state.execution);
+                default:
+                    return state;
+            }
+        },
+    };
+}
+//# sourceMappingURL=run-status.js.map

package/dist/read-model/run-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-status.js","sourceRoot":"","sources":["../../src/read-model/run-status.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAI/D;;;;;;;;;;;;;;GAcG;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG,kBAAkB,CAAA;AAyB1D,MAAM,UAAU,wBAAwB,CACvC,UAAqC,EAAE;IAEvC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAA;IAEnC,MAAM,OAAO,GAAG,CAAC,SAA6B,EAAE,IAAsB,EAAkB,EAAE,CAAC,CAAC;QAC3F,SAAS;QACT,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzB,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC;KACrF,CAAC,CAAA;IAEF,OAAO;QACN,EAAE,EAAE,wBAAwB;QAC5B,sEAAsE;QACtE,mEAAmE;QACnE,0BAA0B;QAC1B,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;QAE9B,KAAK,CAAC,KAAK,EAAE,KAAK;YACjB,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;gBACpB,KAAK,aAAa;oBACjB,OAAO,OAAO,CAAC,SAAS,CAAC,CAAA;gBAC1B,KAAK,eAAe;oBACnB,OAAO,OAAO,CAAC,WAAW,CAAC,CAAA;gBAC5B,KAAK,YAAY;oBAChB,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAA;gBAEzB,KAAK,oBAAoB,CAAC;gBAC1B,KAAK,YAAY;oBAChB,0DAA0D;oBAC1D,uDAAuD;oBACvD,wDAAwD;oBACxD,wDAAwD;oBACxD,2DAA2D;oBAC3D,yCAAyC;oBACzC,EAAE;oBACF,qDAAqD;oBACrD,wDAAwD;oBACxD,wDAAwD;oBACxD,2DAA2D;oBAC3D,0DAA0D;oBAC1D,wDAAwD;oBACxD,sDAAsD;oBACtD,iBAAiB;oBACjB,OAAO,KAAK,CAAA;gBAEb,KAAK,uBAAuB,CAAC;gBAC7B,KAAK,qBAAqB;oBACzB,yDAAyD;oBACzD,uDAAuD;oBACvD,sDAAsD;oBACtD,wDAAwD;oBACxD,0DAA0D;oBAC1D,OAAO,OAAO,CAAC,KAAK,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,EAAE;wBACxE,2DAA2D;wBAC3D,0DAA0D;wBAC1D,uDAAuD;wBACvD,yDAAyD;wBACzD,sDAAsD;wBACtD,mDAAmD;wBACnD,OAAO,EAAE,KAA8C;wBACvD,QAAQ,EAAE,KAAK,CAAC,SAAS;qBACzB,CAAC,CAAA;gBAEH,KAAK,uBAAuB,CAAC;gBAC7B,KAAK,wBAAwB,CAAC;gBAC9B,KAAK,cAAc;oBAClB,4DAA4D;oBAC5D,4DAA4D;oBAC5D,4DAA4D;oBAC5D,4DAA4D;oBAC5D,4CAA4C;oBAC5C,OAAO,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;gBAEhC;oBACC,OAAO,KAAK,CAAA;YACd,CAAC;QACF,CAAC;KACD,CAAA;AACF,CAAC"}

package/dist/registry/{Registry.d.ts → BaseRegistry.d.ts}

@@ -1,4 +1,4 @@
-export declare class Registry<TDefinition> {
+export declare class BaseRegistry<TDefinition> {
     protected items: Map<string, TDefinition>;
     register(id: string, item: TDefinition): void;
     get(id: string): TDefinition | undefined;
@@ -9,4 +9,4 @@ export declare class Registry<TDefinition> {
     clear(): void;
     size(): number;
 }
-//# sourceMappingURL=Registry.d.ts.map
+//# sourceMappingURL=BaseRegistry.d.ts.map

package/dist/registry/BaseRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseRegistry.d.ts","sourceRoot":"","sources":["../../src/registry/BaseRegistry.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAY,CAAC,WAAW;IACpC,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAY;IAErD,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI;IAI7C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIxC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB,MAAM,IAAI,WAAW,EAAE;IAIvB,OAAO,IAAI,MAAM,EAAE;IAInB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI/B,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,MAAM;CAGd"}