@namzu/sdk 0.4.1 → 0.4.3

package/dist/public-runtime.js

@@ -0,0 +1,108 @@
+// Public runtime surface of `@namzu/sdk`.
+//
+// Every runtime value a consumer might need: classes (agents, managers,
+// stores, registries), functions (helpers, ID generators, runtime entry
+// points), zod schemas, constants, error classes. See §4.2 of
+// `docs.local/sessions/ses_011-sdk-public-surface/design.md`.
+//
+// Rule: no type-only exports here (types live in public-types.ts). No tool
+// definitions or builders (tools live in public-tools.ts).
+// ─── version + config ────────────────────────────────────────────────────
+export { VERSION } from './version.js';
+export { CompactionConfigSchema, PluginRuntimeConfigSchema, RUNTIME_DEFAULTS, RuntimeConfigSchema, SandboxConfigSchema, TaskRouterConfigSchema, } from './config/runtime.js';
+// ─── constants ───────────────────────────────────────────────────────────
+export * from './constants/index.js';
+// ─── wire schemas + a2a (contracts/) ─────────────────────────────────────
+export { CreateMessageSchema, CreateRunSchema, CreateStatelessRunSchema, MessageIdSchema, PaginationSchema, ProjectIdSchema, RunConfigSchema, RunIdSchema, zodErrorToApiError, } from './contracts/schemas.js';
+export * from './contracts/a2a.js';
+// ─── ID generators + parsers ─────────────────────────────────────────────
+export * from './utils/id.js';
+// ─── utility helpers ─────────────────────────────────────────────────────
+export { accumulateCost, calculateCost, formatCost, ZERO_COST } from './utils/cost.js';
+export { toErrorMessage } from './utils/error.js';
+export { configureLogger, getRootLogger } from './utils/logger.js';
+export { buildToolResultHashes, hashToolResult } from './utils/hash.js';
+export { compressShellOutput, compressShellOutputFull } from './utils/shell-compress.js';
+export { createChildAbortController } from './utils/abort.js';
+export { memoizeAsync } from './utils/memoize.js';
+export { extractFinalResponse } from './utils/conversation.js';
+// ─── router, runtime, run ────────────────────────────────────────────────
+export { resolveTaskModel } from './router/task-router.js';
+export { drainQuery, query } from './runtime/query/index.js';
+export { ContextCache } from './runtime/query/context-cache.js';
+export { CheckpointManager, projectEmergencyToCheckpoint } from './runtime/query/checkpoint.js';
+export { prepareReplayState } from './runtime/query/replay/prepare.js';
+export { listCheckpoints } from './runtime/query/replay/list.js';
+export { DecisionParser, FallbackResolver } from './runtime/decision/index.js';
+export { buildLimitConfig, checkLimitsDetailed, createRunReporter, } from './run/index.js';
+// ─── personas, skills, advisory ──────────────────────────────────────────
+export { assembleSystemPrompt, mergePersonas, withSessionContext } from './persona/index.js';
+export { discoverSkills, loadSkill, resolveSkillChain, SkillRegistry } from './skills/index.js';
+export { AdvisorRegistry, AdvisoryContext, AdvisoryExecutor, TriggerEvaluator, } from './advisory/index.js';
+// ─── agents ──────────────────────────────────────────────────────────────
+export { AbstractAgent, ConcurrentInvocationError, defineAgent, InvocationLock, PipelineAgent, ReactiveAgent, RouterAgent, SupervisorAgent, } from './agents/index.js';
+// ─── registries, stores, managers, plugin, gateway ───────────────────────
+export { ActivityStore, DiskMemoryStore, DiskTaskStore, InMemoryMemoryIndex, InMemoryMemoryStore, InMemoryStore, InMemoryTaskStore, RunDiskStore, } from './store/index.js';
+export { AgentRegistry, ManagedRegistry, PluginRegistry, Registry, ToolRegistry, } from './registry/index.js';
+export { discoverAllPluginDirs, discoverPlugins, loadPluginManifest, PluginLifecycleManager, PluginResolver, } from './plugin/index.js';
+export { AgentManager, EmergencySaveManager, PlanManager, RunPersistence, } from './manager/index.js';
+export { LocalTaskGateway } from './gateway/local.js';
+// ─── providers, sandbox, vault ───────────────────────────────────────────
+export { DuplicateProviderError, MOCK_CAPABILITIES, MockLLMProvider, ProviderRegistry, registerMock, UnknownProviderError, } from './provider/index.js';
+export { LocalSandboxProvider, SandboxProviderFactory } from './sandbox/index.js';
+export { InMemoryCredentialVault } from './vault/index.js';
+// ─── RAG runtime (generic; createRAGTool is in public-tools.ts) ──────────
+export { assembleRAGContext, cosineSimilarity, DEFAULT_CHUNKING_CONFIG, DEFAULT_RAG_CONTEXT_CONFIG, DEFAULT_RETRIEVAL_CONFIG, DefaultIngestionPipeline, DefaultKnowledgeBase, DefaultRetriever, InMemoryVectorStore, OpenRouterEmbeddingProvider, TextChunker, } from './rag/index.js';
+// ─── connectors ──────────────────────────────────────────────────────────
+export { BaseConnector, BaseExecutionContext, ConnectorManager, ConnectorRegistry, EnvironmentConnectorManager, ExecutionContextFactory, HttpConnector, HttpSseTransport, HybridExecutionContext, LocalExecutionContext, MCPClient, MCPConnectorBridge, MCPServer, MCPToolDiscovery, mcpJsonSchemaToZod, mcpToolResultToToolResult, mcpToolToToolDefinition, RemoteExecutionContext, ScopedConnectorRegistry, StdioTransport, TenantConnectorManager, toolDefinitionToMCPTool, toolResultToMCPToolResult, WebhookConnector, zodToMCPJsonSchema, } from './connector/index.js';
+// ─── bridges (a2a + sse) ─────────────────────────────────────────────────
+export { a2aMessageToCreateRun, a2aMessageToInput, buildAgentCard, extractTextFromA2AMessage, isTerminalState, mapRunToA2AEvent, mapSessionToA2AEvent, messageToA2A, runStatusToA2AState, runToA2ATask, } from './bridge/a2a/index.js';
+export { mapRunToStreamEvent, mapSessionToStreamEvent } from './bridge/sse/index.js';
+// ─── bus, verification ───────────────────────────────────────────────────
+export { AgentBus, CircuitBreaker, EditOwnershipTracker, FileLockManager, } from './bus/index.js';
+export { evaluateRule, VerificationGate } from './verification/index.js';
+// ─── session runtime — explicit named lists, no `export *` ───────────────
+// See §1.5 + §4.2 of design.md. Types flow through public-types.ts.
+export { RUN_EVENT_SCHEMA_VERSION } from './session/events/index.js';
+export { DefaultPathBuilder, GitWorktreeDriver, parseWorktreeList, WorkspaceBackendRegistry, } from './session/workspace/index.js';
+export { DefaultCapacityValidator, DelegationCapacityExceeded, executeBroadcastHandoff, executeSingleHandoff, HandoffLockRejected, HandoffVersionConflict, NOOP_HANDOFF_SINK, NOOP_RUN_STATUS_RESOLVER, } from './session/handoff/index.js';
+export { AGENT_SUMMARY_MAX_CHARS, AgentSummaryTooLongError, SessionAlreadySummarizedError, SessionSummaryMaterializer, } from './session/summary/index.js';
+export { ArtifactRefCycleError, InterventionDepthExceeded, validatePrevArtifactChain, } from './session/intervention/index.js';
+export { acceptLegacyThreadId, acquireMigrationLock, DefaultFilesystemMigrator, FilesystemMigrationError, LEGACY_DEFAULT_PROJECT_PREFIX, LEGACY_DEFAULT_SESSION_ID, LOCK_REL_PATH, MARKER_REL_PATH, MIGRATION_VERSION, NOOP_FILESYSTEM_MIGRATION_SINK, NOOP_MIGRATION_WARNING_SINK, readMarker, rejectLegacyPrefix, releaseMigrationLock, StalePrefixError, WINDOW_OPEN, writeMarker, } from './session/migration/index.js';
+export { ArchivalManager, ArchiveNotConfiguredError, ArchiveNotFoundError, DiskArchiveBackend, RETENTION_POLICY_DISABLED, SubSessionNotArchivableError, SubSessionNotArchivedError, } from './session/retention/index.js';
+// NOTE: `deriveStatus` intentionally NOT re-exported here — it was not part
+// of the pre-ses_011 public surface. Consumers needing it import from the
+// internal path. Promoting it to public surface requires an explicit
+// follow-up session.
+export { AncestryCycleError, TenantIsolationError, WorkspaceBackendError, } from './session/errors.js';
+// ─── store/session runtime — explicit named (types live in public-types.ts)
+export { DiskSessionStore, getAncestry, getChildren, InMemorySessionStore, orderChildren, } from './store/session/index.js';
+// ─── runtime helpers colocated with shapes under `types/` (§1.5) ─────────
+export { A2AProtocolError } from './types/a2a/index.js';
+export { isTerminalActivityStatus, resolveActivityTracking } from './types/activity/index.js';
+export { isTerminalAgentTaskState } from './types/agent/task.js';
+export { accumulateTokenUsage, isTerminalStatus } from './types/common/index.js';
+export { assertComputerUseActionType, assertDisplayServer } from './types/computer-use/index.js';
+export { isConnectorActive } from './types/connector/core.js';
+export { CONNECTOR_SCOPE_ORDER } from './types/connector/scope.js';
+export { RoutingResponseSchema } from './types/decision/index.js';
+export { autoApproveHandler } from './types/hitl/index.js';
+export { UNKNOWN_TENANT_ID } from './types/ids/index.js';
+export { deriveChildState } from './types/invocation/index.js';
+export { assertMemoryStatus } from './types/memory/index.js';
+export { createAssistantMessage, createSystemMessage, createToolMessage, createUserMessage, } from './types/message/index.js';
+export { isTerminalPlanStatus } from './types/plan/index.js';
+export { assertPluginContributionType, assertPluginHookEvent, assertPluginHookResult, assertPluginScope, assertPluginStatus, PluginManifestSchema, PluginMCPServerConfigSchema, } from './types/plugin/index.js';
+export { EmergencySaveConfigSchema } from './types/run/emergency.js';
+export { MutationNotApplicableError } from './types/run/replay.js';
+export { assertSandboxEnvironment, assertSandboxStatus, } from './types/sandbox/index.js';
+// `SandboxConfigSchema` is already re-exported above from `./config/runtime.js`
+// (the project-wide config barrel surfaces it first). types/sandbox also exports
+// one under the same name; `@namzu/sdk` root barrel exposes one symbol — the
+// config/runtime version is the canonical path. Keep it out of this block.
+export { assertTaskStatus, isTerminalTaskStatus } from './types/task/index.js';
+// NOTE: `VerificationRuleSchema` and `VerificationGateConfigSchema` are NOT
+// re-exported — they were not part of the pre-ses_011 public surface.
+// ─── compaction runtime ──────────────────────────────────────────────────
+export { buildVerifiedSummary, createConversationManager, extractFromAssistantMessage, extractFromToolCall, extractFromToolResult, extractFromUserMessage, findDanglingMessages, findSafeTrimIndex, NullManager, removeDanglingMessages, serializeState, SlidingWindowManager, StructuredCompactionManager, WorkingStateManager, } from './compaction/index.js';
+//# sourceMappingURL=public-runtime.js.map

package/dist/public-runtime.js.map

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

package/dist/public-tools.d.ts

@@ -0,0 +1,19 @@
+export { defineTool } from './tools/defineTool.js';
+export { getBuiltinTools } from './tools/builtins/index.js';
+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 { GlobTool } from './tools/builtins/glob.js';
+export { GrepTool } from './tools/builtins/grep.js';
+export { LsTool } from './tools/builtins/ls.js';
+export { SearchToolsTool } from './tools/builtins/search-tools.js';
+export { createStructuredOutputTool, STRUCTURED_OUTPUT_TOOL_NAME, } from './tools/builtins/structuredOutput.js';
+export { COMPUTER_USE_TOOL_NAME, createComputerUseTool, } from './tools/builtins/computer-use.js';
+export { buildTaskCreateTool, buildTaskListTool, buildTaskTools, buildTaskUpdateTool, } from './tools/task/index.js';
+export { buildAdvisoryTools } from './tools/advisory/index.js';
+export { buildMemoryTools } from './tools/memory/index.js';
+export { buildCoordinatorTools } from './tools/coordinator/index.js';
+export { createRAGTool } from './rag/index.js';
+export { allConnectorTools, connectorInstanceToTools, connectorMethodToTool, ConnectorToolRouter, createConnectorExecuteTool, createConnectorListTool, createConnectorRouterTool, createConnectorTools, } from './bridge/tools/connector/index.js';
+//# sourceMappingURL=public-tools.d.ts.map

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

@@ -0,0 +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,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,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;AAIpE,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"}

package/dist/public-tools.js

@@ -0,0 +1,34 @@
+// Public tools surface of `@namzu/sdk`.
+//
+// Consumer scenario: "I want to define a tool for my agent, use a built-in
+// tool, or produce Tool objects from a connector / RAG store / task system."
+//
+// Every symbol here produces or defines a Tool in the agent-tool sense.
+// Generic RAG runtime (vector stores, retrievers, embeddings, knowledge
+// base) lives in `public-runtime.ts`; only `createRAGTool` belongs here.
+//
+// See §4.3 of `docs.local/sessions/ses_011-sdk-public-surface/design.md`.
+// ─── Tool definition primitive ───────────────────────────────────────────
+export { defineTool } from './tools/defineTool.js';
+// ─── Built-in tools ──────────────────────────────────────────────────────
+export { getBuiltinTools } from './tools/builtins/index.js';
+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 { GlobTool } from './tools/builtins/glob.js';
+export { GrepTool } from './tools/builtins/grep.js';
+export { LsTool } from './tools/builtins/ls.js';
+export { SearchToolsTool } from './tools/builtins/search-tools.js';
+export { createStructuredOutputTool, STRUCTURED_OUTPUT_TOOL_NAME, } from './tools/builtins/structuredOutput.js';
+export { COMPUTER_USE_TOOL_NAME, createComputerUseTool, } from './tools/builtins/computer-use.js';
+// ─── Domain tool builders ────────────────────────────────────────────────
+export { buildTaskCreateTool, buildTaskListTool, buildTaskTools, buildTaskUpdateTool, } from './tools/task/index.js';
+export { buildAdvisoryTools } from './tools/advisory/index.js';
+export { buildMemoryTools } from './tools/memory/index.js';
+export { buildCoordinatorTools } from './tools/coordinator/index.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';
+//# sourceMappingURL=public-tools.js.map

package/dist/public-tools.js.map

@@ -0,0 +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,0EAA0E;AAE1E,4EAA4E;AAE5E,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAElD,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,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;AAEpE,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"}

package/dist/public-types.d.ts

@@ -0,0 +1,55 @@
+export type * from './types/ids/index.js';
+export type * from './types/message/index.js';
+export type * from './types/common/index.js';
+export type * from './types/tool/index.js';
+export type * from './types/permission/index.js';
+export type * from './types/run/index.js';
+export type * from './types/provider/index.js';
+export type * from './types/agent/index.js';
+export type * from './types/decision/index.js';
+export type * from './types/persona/index.js';
+export type * from './types/activity/index.js';
+export type * from './types/task/index.js';
+export type * from './types/plan/index.js';
+export type * from './types/hitl/index.js';
+export type * from './types/rag/index.js';
+export type * from './types/execution/index.js';
+export type * from './types/connector/index.js';
+export type * from './types/skills/index.js';
+export type * from './types/a2a/index.js';
+export type * from './types/router/index.js';
+export type * from './types/advisory/index.js';
+export type * from './types/memory/index.js';
+export type * from './types/plugin/index.js';
+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/session/index.js';
+export type { AgentDefaults, AgentInfo, ApiError, ApiErrorType, ApiPermissionMode, CreateMessageRequest, CreateRunRequest, CreateStatelessRunRequest, ISOTimestamp, PaginatedResponse, PaginationParams, RunConfig, RunHierarchyNode, RunStopReason, RunUsage, StreamEvent, StreamEventType, ToolCallInfo, WireRun, WireRunStatus, } from './contracts/api.js';
+export type { CompactionConfig, PluginRuntimeConfig, RuntimeConfig, } from './config/runtime.js';
+export type { AdvisoryCallContext, AdvisoryExecutionResult } from './advisory/index.js';
+export type { ModelPricing } from './utils/cost.js';
+export type { Logger } from './utils/logger.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 { LimitCheckResult, LimitCheckerState, RunReporter } from './run/index.js';
+export type { ConcurrencyMode, DefineAgentOptions, Disposable } from './agents/index.js';
+export type { ActivityEvent, ActivityEventListener, DiskMemoryStoreConfig, DiskTaskStoreConfig, Identifiable, Timestamped, } from './store/index.js';
+export type { ManagedRegistryConfig, ToolExecutionResult } from './registry/index.js';
+export type { PluginLifecycleManagerConfig } from './plugin/lifecycle.js';
+export type { PlanApprovalHandler, PlanEvent, PlanEventListener } from './manager/index.js';
+export type { DefineToolOptions } from './tools/defineTool.js';
+export type { AdvisoryToolsOptions } from './tools/advisory/index.js';
+export type { CoordinatorToolsOptions, TaskLaunchedCallback } from './tools/coordinator/index.js';
+export type { ConnectorManagerConfig, EnvironmentConnectorManagerConfig, EnvironmentConnectorSetup, HybridExecutionContextOptions, LocalExecutionContextOptions, MCPServerResourceProvider, MCPServerToolProvider, RemoteExecutionContextOptions, TenantConnectorManagerConfig, } from './connector/index.js';
+export type { ConnectorRouterInput, ConnectorToolConfig, ConnectorToolRouterConfig, ConnectorToolStrategy, } from './bridge/tools/connector/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 { DiskSessionStoreConfig, LinkageView } from './store/session/index.js';
+export type { ConversationManager, CompactionStrategy, DanglingResult, FileAction, FileSlot, PlanSlot, ToolResultSlot, WorkingState, } from './compaction/index.js';
+//# sourceMappingURL=public-types.d.ts.map

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

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

package/dist/public-types.js

@@ -0,0 +1,14 @@
+// Public types surface of `@namzu/sdk`.
+//
+// Every pure shape a consumer might need for TypeScript type-checking:
+// branded IDs, wire types, domain entities, discriminated unions, store
+// contracts, event unions, config types.
+//
+// Rule: this file contains ONLY `export type` statements. Runtime values
+// (classes, functions, constants, zod schemas, errors) live in
+// `public-runtime.ts`. Tool builders live in `public-tools.ts`.
+//
+// See `docs.local/sessions/ses_011-sdk-public-surface/design.md` for the
+// three-bucket taxonomy and migration rationale.
+export {};
+//# sourceMappingURL=public-types.js.map

package/dist/public-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-types.js","sourceRoot":"","sources":["../src/public-types.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,EAAE;AACF,uEAAuE;AACvE,wEAAwE;AACxE,yCAAyC;AACzC,EAAE;AACF,yEAAyE;AACzE,+DAA+D;AAC/D,gEAAgE;AAChE,EAAE;AACF,yEAAyE;AACzE,iDAAiD"}

package/dist/rag/chunking.test.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 4):
+ *
+ *   - `TextChunker.chunk(content, config)` dispatches by
+ *     `config.strategy`. Unknown strategy hits an exhaustive-check
+ *     throw (unreachable via types).
+ *   - `fixed` strategy: slides a window of `chunkSize` by
+ *     `chunkSize − chunkOverlap` (min 1) and emits trimmed non-empty
+ *     slices. Indices are 0-based and contiguous.
+ *   - `sentence` / `paragraph` strategies split by their separator
+ *     sets and then merge small parts until the budget fills.
+ *   - `recursive` strategy: short content returns as a single chunk;
+ *     otherwise it splits by the first separator that produces >1
+ *     parts, merges, and recurses into parts that still exceed
+ *     `chunkSize`. Falls back to `fixed` when no separator splits.
+ *   - Overlap is applied in `mergeSmallParts` via
+ *     `current.slice(current.length - chunkOverlap) + part`.
+ */
+export {};
+//# sourceMappingURL=chunking.test.d.ts.map

package/dist/rag/chunking.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunking.test.d.ts","sourceRoot":"","sources":["../../src/rag/chunking.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/rag/chunking.test.js

@@ -0,0 +1,92 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 4):
+ *
+ *   - `TextChunker.chunk(content, config)` dispatches by
+ *     `config.strategy`. Unknown strategy hits an exhaustive-check
+ *     throw (unreachable via types).
+ *   - `fixed` strategy: slides a window of `chunkSize` by
+ *     `chunkSize − chunkOverlap` (min 1) and emits trimmed non-empty
+ *     slices. Indices are 0-based and contiguous.
+ *   - `sentence` / `paragraph` strategies split by their separator
+ *     sets and then merge small parts until the budget fills.
+ *   - `recursive` strategy: short content returns as a single chunk;
+ *     otherwise it splits by the first separator that produces >1
+ *     parts, merges, and recurses into parts that still exceed
+ *     `chunkSize`. Falls back to `fixed` when no separator splits.
+ *   - Overlap is applied in `mergeSmallParts` via
+ *     `current.slice(current.length - chunkOverlap) + part`.
+ */
+import { describe, expect, it } from 'vitest';
+import { TextChunker } from './chunking.js';
+const chunker = new TextChunker();
+describe('TextChunker — fixed', () => {
+    const fixed = { strategy: 'fixed', chunkSize: 10, chunkOverlap: 2 };
+    it('emits trimmed non-empty slices with contiguous indices', () => {
+        const result = chunker.chunk('0123456789abcdefghij', fixed);
+        expect(result).toHaveLength(3);
+        expect(result.map((c) => c.index)).toEqual([0, 1, 2]);
+    });
+    it('skips whitespace-only slices', () => {
+        const result = chunker.chunk('abc           def', {
+            strategy: 'fixed',
+            chunkSize: 5,
+            chunkOverlap: 0,
+        });
+        expect(result.map((c) => c.content)).not.toContain('');
+    });
+    it('clamps step to at least 1 when overlap >= chunkSize', () => {
+        const result = chunker.chunk('abcdefghij', {
+            strategy: 'fixed',
+            chunkSize: 3,
+            chunkOverlap: 3,
+        });
+        // step = max(1, 3-3) = 1; eagerly emits many overlapping slices
+        expect(result.length).toBeGreaterThan(1);
+    });
+});
+describe('TextChunker — sentence', () => {
+    it('splits by sentence separators and merges up to the budget', () => {
+        const result = chunker.chunk('First sentence. Second sentence. Third sentence.', {
+            strategy: 'sentence',
+            chunkSize: 100,
+            chunkOverlap: 0,
+        });
+        expect(result.length).toBeGreaterThanOrEqual(1);
+        expect(result[0]?.content).toContain('First sentence');
+    });
+});
+describe('TextChunker — paragraph', () => {
+    it('splits by paragraph separators', () => {
+        const result = chunker.chunk('para one\n\npara two\n\npara three', {
+            strategy: 'paragraph',
+            chunkSize: 200,
+            chunkOverlap: 0,
+        });
+        expect(result.length).toBeGreaterThanOrEqual(1);
+    });
+});
+describe('TextChunker — recursive', () => {
+    it('short content fits into a single chunk', () => {
+        const result = chunker.chunk('tiny', {
+            strategy: 'recursive',
+            chunkSize: 100,
+            chunkOverlap: 0,
+        });
+        expect(result).toEqual([{ content: 'tiny', index: 0 }]);
+    });
+    it('long content recursively splits to stay within chunkSize', () => {
+        const content = 'paragraph one. more text.\n\nparagraph two. more.';
+        const result = chunker.chunk(content, {
+            strategy: 'recursive',
+            chunkSize: 30,
+            chunkOverlap: 0,
+        });
+        for (const c of result) {
+            expect(c.content.length).toBeLessThanOrEqual(30);
+        }
+    });
+    it('empty or whitespace-only content yields empty result', () => {
+        expect(chunker.chunk('   ', { strategy: 'recursive', chunkSize: 10, chunkOverlap: 0 })).toEqual([]);
+    });
+});
+//# sourceMappingURL=chunking.test.js.map

package/dist/rag/chunking.test.js.map

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

package/dist/rag/context-assembler.test.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 4):
+ *
+ *   - `assembleRAGContext([], cfg)` returns `{content: '', sources: [],
+ *     tokenCount: 0}` immediately.
+ *   - Token estimation: `Math.ceil(text.length / 4)`.
+ *   - `headerTemplate` is prepended before any chunks.
+ *   - Chunks are included in order while their accumulated token count
+ *     stays below `maxTokens`; the first chunk that would overflow is
+ *     dropped along with every subsequent chunk (early break).
+ *   - `includeMetadata: true` prefixes each chunk with a bracketed
+ *     metadata line (`Source: …`, `Title: …`, `Relevance: XX.X%`).
+ *   - `sources[]` captures a truncated preview (first 200 chars) of
+ *     each INCLUDED chunk; skipped chunks are NOT present.
+ *   - `content` is the joined parts with `config.separator`;
+ *     `tokenCount` is re-estimated from the joined content.
+ */
+export {};
+//# sourceMappingURL=context-assembler.test.d.ts.map

package/dist/rag/context-assembler.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-assembler.test.d.ts","sourceRoot":"","sources":["../../src/rag/context-assembler.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}

package/dist/rag/context-assembler.test.js

@@ -0,0 +1,98 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 4):
+ *
+ *   - `assembleRAGContext([], cfg)` returns `{content: '', sources: [],
+ *     tokenCount: 0}` immediately.
+ *   - Token estimation: `Math.ceil(text.length / 4)`.
+ *   - `headerTemplate` is prepended before any chunks.
+ *   - Chunks are included in order while their accumulated token count
+ *     stays below `maxTokens`; the first chunk that would overflow is
+ *     dropped along with every subsequent chunk (early break).
+ *   - `includeMetadata: true` prefixes each chunk with a bracketed
+ *     metadata line (`Source: …`, `Title: …`, `Relevance: XX.X%`).
+ *   - `sources[]` captures a truncated preview (first 200 chars) of
+ *     each INCLUDED chunk; skipped chunks are NOT present.
+ *   - `content` is the joined parts with `config.separator`;
+ *     `tokenCount` is re-estimated from the joined content.
+ */
+import { describe, expect, it } from 'vitest';
+import { assembleRAGContext } from './context-assembler.js';
+function result(content, score = 0.9, meta = {}) {
+    return {
+        chunk: {
+            id: `c_${content.slice(0, 3)}`,
+            documentId: 'doc_1',
+            knowledgeBaseId: 'kb_1',
+            tenantId: 't_1',
+            content,
+            index: 0,
+            tokenCount: 0,
+            metadata: meta,
+            createdAt: 0,
+        },
+        score,
+    };
+}
+describe('assembleRAGContext', () => {
+    it('returns empty for empty input', () => {
+        expect(assembleRAGContext([])).toEqual({ content: '', sources: [], tokenCount: 0 });
+    });
+    it('joins non-empty chunks with the configured separator', () => {
+        const ctx = assembleRAGContext([result('alpha'), result('beta')], {
+            separator: ' | ',
+            maxTokens: 1000,
+            includeMetadata: false,
+            headerTemplate: undefined,
+        });
+        expect(ctx.content).toBe('alpha | beta');
+    });
+    it('includes a headerTemplate before chunks when provided', () => {
+        const ctx = assembleRAGContext([result('body')], {
+            separator: '\n',
+            maxTokens: 1000,
+            includeMetadata: false,
+            headerTemplate: '### Knowledge',
+        });
+        expect(ctx.content.startsWith('### Knowledge\n')).toBe(true);
+    });
+    it('early-breaks once a chunk would overflow maxTokens (and drops subsequent)', () => {
+        const long = 'a'.repeat(200); // ~50 tokens per the /4 estimate
+        const ctx = assembleRAGContext([result('tiny'), result(long), result('also-tiny')], {
+            separator: '\n',
+            maxTokens: 20,
+            includeMetadata: false,
+            headerTemplate: undefined,
+        });
+        expect(ctx.content).toBe('tiny');
+        // third chunk was NOT included even though it would fit — the loop breaks on first overflow.
+        expect(ctx.sources.map((s) => s.chunk.slice(0, 10))).toEqual(['tiny']);
+    });
+    it('includeMetadata prefixes entries with bracketed metadata', () => {
+        const ctx = assembleRAGContext([result('body', 0.7567, { source: 'repo', title: 'README' })], {
+            separator: '\n',
+            maxTokens: 1000,
+            includeMetadata: true,
+        });
+        expect(ctx.content).toContain('[Source: repo | Title: README | Relevance: 75.7%]');
+    });
+    it('sources[] carries the first 200 chars of each included chunk', () => {
+        const long = 'x'.repeat(500);
+        const ctx = assembleRAGContext([result(long)], {
+            separator: '\n',
+            maxTokens: 10000,
+            includeMetadata: false,
+        });
+        expect(ctx.sources[0]?.chunk).toHaveLength(200);
+    });
+    it('tokenCount is derived from the final joined content', () => {
+        const ctx = assembleRAGContext([result('abcd'), result('efgh')], {
+            separator: '',
+            maxTokens: 1000,
+            includeMetadata: false,
+            headerTemplate: undefined,
+        });
+        // 'abcdefgh' → Math.ceil(8 / 4) = 2
+        expect(ctx.tokenCount).toBe(2);
+    });
+});
+//# sourceMappingURL=context-assembler.test.js.map

package/dist/rag/context-assembler.test.js.map

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

package/dist/rag/embedding.test.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Current-code invariants asserted (2026-04-21, ses_006 Phase 4):
+ *
+ *   - `OpenRouterEmbeddingProvider`:
+ *     - Defaults: dimensions = 1536; baseUrl = openrouter.ai/api/v1;
+ *       batchSize = 64.
+ *     - `embed(texts)` batches into `batchSize` slices and concatenates
+ *       results in input order.
+ *     - Each HTTP call posts `{model, input, dimensions}` to
+ *       `${baseUrl}/embeddings` with the Bearer authorization header.
+ *     - The API response is sorted by `index` ascending before extracting
+ *       `.embedding`, so results match input order even if the server
+ *       re-orders.
+ *     - `embedQuery(query)` returns the first result from `embed([query])`;
+ *       throws when the response is empty.
+ *     - `!response.ok` → throws with `Embedding API error (<status>): <body>`.
+ */
+export {};
+//# sourceMappingURL=embedding.test.d.ts.map

package/dist/rag/embedding.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding.test.d.ts","sourceRoot":"","sources":["../../src/rag/embedding.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}