@namzu/sdk 0.4.1 → 0.4.2

package/src/index.ts

@@ -1,362 +1,11 @@
-export { VERSION } from './version.js'
-export {
-	RuntimeConfigSchema,
-	TaskRouterConfigSchema,
-	CompactionConfigSchema,
-	PluginRuntimeConfigSchema,
-	SandboxConfigSchema,
-	RUNTIME_DEFAULTS,
-} from './config/runtime.js'
-export type {
-	RuntimeConfig,
-	CompactionConfig,
-	PluginRuntimeConfig,
-} from './config/runtime.js'
-
-export * from './constants/index.js'
-
-export * from './contracts/index.js'
-
-export * from './types/ids/index.js'
-export * from './types/message/index.js'
-export * from './types/common/index.js'
-export * from './types/tool/index.js'
-export * from './types/permission/index.js'
-export * from './types/run/index.js'
-// Domain `RunStatus` (session-hierarchy.md §4.6 state machine). Re-exported
-// explicitly because `types/run/index.js` intentionally skips `status.js` to
-// avoid colliding with the deprecated wire alias in `contracts/api.ts`
-// (renamed to `WireRunStatus` in 0.2.0 — Phase 9 Known Delta #2).
-export type { RunStatus } from './types/run/status.js'
-export * from './types/provider/index.js'
-export * from './types/agent/index.js'
-export * from './types/decision/index.js'
-export * from './types/persona/index.js'
-export * from './types/activity/index.js'
-export * from './types/task/index.js'
-export * from './types/plan/index.js'
-export * from './types/hitl/index.js'
-export * from './types/rag/index.js'
-export * from './types/execution/index.js'
-export * from './types/connector/index.js'
-export * from './types/skills/index.js'
-export * from './types/a2a/index.js'
-export * from './types/router/index.js'
-export * from './types/advisory/index.js'
-export * from './types/memory/index.js'
-export * from './types/plugin/index.js'
-export * from './types/sandbox/index.js'
-export * from './types/structured-output/index.js'
-export * from './types/invocation/index.js'
-export * from './types/computer-use/index.js'
-// Session hierarchy types (Phase 9 — public API freeze for 0.2.0).
-// Types-only re-export; runtime primitives come via `./session/index.js`
-// and `./store/session/index.js` below.
-export type * from './types/session/index.js'
-
-export {
-	AdvisorRegistry,
-	AdvisoryExecutor,
-	TriggerEvaluator,
-	AdvisoryContext,
-} from './advisory/index.js'
-export type {
-	AdvisoryCallContext,
-	AdvisoryExecutionResult,
-} from './advisory/index.js'
-
-export {
-	assembleSystemPrompt,
-	mergePersonas,
-	withSessionContext,
-} from './persona/index.js'
-export {
-	SkillRegistry,
-	resolveSkillChain,
-	loadSkill,
-	discoverSkills,
-} from './skills/index.js'
-
-export * from './utils/id.js'
-export * from './utils/cost.js'
-export * from './utils/error.js'
-export * from './utils/logger.js'
-export { hashToolResult, buildToolResultHashes } from './utils/hash.js'
-export {
-	compressShellOutput,
-	compressShellOutputFull,
-} from './utils/shell-compress.js'
-export type {
-	ShellCompressResult,
-	ShellCompressOptions,
-} from './utils/shell-compress.js'
-export { createChildAbortController } from './utils/abort.js'
-export { memoizeAsync } from './utils/memoize.js'
-export { extractFinalResponse } from './utils/conversation.js'
-
-export { resolveTaskModel } from './router/task-router.js'
-
-export { query, drainQuery } from './runtime/query/index.js'
-export type { QueryParams } from './runtime/query/index.js'
-export { ContextCache } from './runtime/query/context-cache.js'
-export type {
-	ContextCacheConfig,
-	PromptCacheInput,
-} from './runtime/query/context-cache.js'
-export { CheckpointManager } from './runtime/query/checkpoint.js'
-export { DecisionParser, FallbackResolver } from './runtime/decision/index.js'
-
-export {
-	createRunReporter,
-	type RunReporter,
-	checkLimitsDetailed,
-	buildLimitConfig,
-	type LimitCheckerState,
-	type LimitCheckResult,
-} from './run/index.js'
-
-export {
-	AbstractAgent,
-	ReactiveAgent,
-	PipelineAgent,
-	RouterAgent,
-	SupervisorAgent,
-	defineAgent,
-	InvocationLock,
-	ConcurrentInvocationError,
-} from './agents/index.js'
-export type { DefineAgentOptions, ConcurrencyMode, Disposable } from './agents/index.js'
-
-export {
-	InMemoryStore,
-	type Identifiable,
-	type Timestamped,
-	RunDiskStore,
-	ActivityStore,
-	type ActivityEvent,
-	type ActivityEventListener,
-	InMemoryTaskStore,
-	DiskTaskStore,
-	type DiskTaskStoreConfig,
-	InMemoryMemoryIndex,
-	InMemoryMemoryStore,
-	DiskMemoryStore,
-	type DiskMemoryStoreConfig,
-} from './store/index.js'
-
-export {
-	Registry,
-	ManagedRegistry,
-	type ManagedRegistryConfig,
-	AgentRegistry,
-	PluginRegistry,
-	ToolRegistry,
-	type ToolExecutionResult,
-} from './registry/index.js'
-
-export {
-	PluginLifecycleManager,
-	PluginResolver,
-	discoverPlugins,
-	loadPluginManifest,
-	discoverAllPluginDirs,
-} from './plugin/index.js'
-export type { PluginLifecycleManagerConfig } from './plugin/lifecycle.js'
-
-export {
-	RunPersistence,
-	EmergencySaveManager,
-	PlanManager,
-	type PlanEvent,
-	type PlanEventListener,
-	type PlanApprovalHandler,
-	AgentManager,
-} from './manager/index.js'
-
-export {
-	buildTaskTools,
-	buildTaskCreateTool,
-	buildTaskUpdateTool,
-	buildTaskListTool,
-} from './tools/task/index.js'
-export { buildAdvisoryTools } from './tools/advisory/index.js'
-export type { AdvisoryToolsOptions } from './tools/advisory/index.js'
-export { buildMemoryTools } from './tools/memory/index.js'
-export { LocalTaskGateway } from './gateway/local.js'
-
-export {
-	ProviderRegistry,
-	UnknownProviderError,
-	DuplicateProviderError,
-	MockLLMProvider,
-	registerMock,
-	MOCK_CAPABILITIES,
-} from './provider/index.js'
-
-export {
-	LocalSandboxProvider,
-	SandboxProviderFactory,
-} from './sandbox/index.js'
-
-export { defineTool } from './tools/defineTool.js'
-export type { DefineToolOptions } 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 {
-	createComputerUseTool,
-	COMPUTER_USE_TOOL_NAME,
-} from './tools/builtins/computer-use.js'
-
-export {
-	TextChunker,
-	DEFAULT_CHUNKING_CONFIG,
-	OpenRouterEmbeddingProvider,
-	InMemoryVectorStore,
-	cosineSimilarity,
-	DefaultRetriever,
-	DEFAULT_RETRIEVAL_CONFIG,
-	DefaultIngestionPipeline,
-	assembleRAGContext,
-	DEFAULT_RAG_CONTEXT_CONFIG,
-	DefaultKnowledgeBase,
-	createRAGTool,
-} from './rag/index.js'
-
-export {
-	BaseConnector,
-	ConnectorRegistry,
-	ConnectorManager,
-	HttpConnector,
-	WebhookConnector,
-	ScopedConnectorRegistry,
-	TenantConnectorManager,
-	EnvironmentConnectorManager,
-	BaseExecutionContext,
-	LocalExecutionContext,
-	RemoteExecutionContext,
-	HybridExecutionContext,
-	ExecutionContextFactory,
-	StdioTransport,
-	HttpSseTransport,
-	MCPClient,
-	mcpToolToToolDefinition,
-	toolDefinitionToMCPTool,
-	mcpJsonSchemaToZod,
-	zodToMCPJsonSchema,
-	mcpToolResultToToolResult,
-	toolResultToMCPToolResult,
-	MCPToolDiscovery,
-	MCPConnectorBridge,
-	MCPServer,
-} from './connector/index.js'
-export type {
-	ConnectorManagerConfig,
-	TenantConnectorManagerConfig,
-	EnvironmentConnectorSetup,
-	EnvironmentConnectorManagerConfig,
-	LocalExecutionContextOptions,
-	RemoteExecutionContextOptions,
-	HybridExecutionContextOptions,
-	MCPServerToolProvider,
-	MCPServerResourceProvider,
-} from './connector/index.js'
-
-export {
-	createConnectorExecuteTool,
-	createConnectorListTool,
-	createConnectorTools,
-	connectorMethodToTool,
-	connectorInstanceToTools,
-	allConnectorTools,
-	createConnectorRouterTool,
-	ConnectorToolRouter,
-} from './bridge/tools/connector/index.js'
-export type {
-	ConnectorToolConfig,
-	ConnectorRouterInput,
-	ConnectorToolStrategy,
-	ConnectorToolRouterConfig,
-} from './bridge/tools/connector/index.js'
-
-export {
-	buildAgentCard,
-	runToA2ATask,
-	isTerminalState,
-	runStatusToA2AState,
-	a2aMessageToCreateRun,
-	messageToA2A,
-	extractTextFromA2AMessage,
-	a2aMessageToInput,
-	mapRunToA2AEvent,
-	mapSessionToA2AEvent,
-} from './bridge/a2a/index.js'
-export type { CreateRunFromA2A } from './bridge/a2a/index.js'
-
-export {
-	mapRunToStreamEvent,
-	mapSessionToStreamEvent,
-} from './bridge/sse/index.js'
-export type { MappedStreamEvent } from './bridge/sse/index.js'
-
-export {
-	AgentBus,
-	CircuitBreaker,
-	FileLockManager,
-	EditOwnershipTracker,
-} from './bus/index.js'
-export type { AgentBusConfig } from './bus/index.js'
-
-export { VerificationGate, evaluateRule } from './verification/index.js'
-export type { ToolCallContext } from './verification/index.js'
-
-export { buildCoordinatorTools } from './tools/coordinator/index.js'
-export type { CoordinatorToolsOptions, TaskLaunchedCallback } from './tools/coordinator/index.js'
-
-export { InMemoryCredentialVault } from './vault/index.js'
-
-// Telemetry runtime surface moved to `@namzu/telemetry` in 0.4.0.
-// See docs/migration/0.4.md. Consumers import from `@namzu/telemetry`
-// and `@namzu/telemetry/attributes` instead of the SDK barrel.
-
-// Session hierarchy runtime primitives (Phase 9 — public API freeze for 0.2.0).
-// Convention #4: root barrel imports sub-barrels only, never concrete files.
-export * from './session/index.js'
-export * from './store/session/index.js'
-
-export {
-	WorkingStateManager,
-	serializeState,
-	extractFromToolCall,
-	extractFromToolResult,
-	extractFromUserMessage,
-	extractFromAssistantMessage,
-	buildVerifiedSummary,
-	findDanglingMessages,
-	removeDanglingMessages,
-	findSafeTrimIndex,
-	NullManager,
-	SlidingWindowManager,
-	StructuredCompactionManager,
-	createConversationManager,
-} from './compaction/index.js'
-export type {
-	WorkingState,
-	PlanSlot,
-	FileSlot,
-	FileAction,
-	ToolResultSlot,
-	CompactionStrategy,
-	DanglingResult,
-	ConversationManager,
-} from './compaction/index.js'
+// Public SDK surface — split into three focused files by scenario:
+//   - public-types.ts    : every type a consumer type-checks against
+//   - public-runtime.ts  : every runtime value (classes, functions, consts, schemas)
+//   - public-tools.ts    : tool-definition primitive + builtins + builders
+//
+// ses_011 (2026-04-21): this file is a thin bootstrap. Do not add symbols
+// here directly — extend the appropriate bucket file.
+
+export type * from './public-types.js'
+export * from './public-runtime.js'
+export * from './public-tools.js'

package/src/manager/agent/__tests__/lifecycle.test.ts

@@ -5,8 +5,6 @@ import {
 	DefaultCapacityValidator,
 	DelegationCapacityExceeded,
 } from '../../../session/handoff/capacity.js'
-import type { ActorRef } from '../../../session/hierarchy/actor.js'
-import type { DeliverableRef } from '../../../session/summary/deliverable.js'
 import { SessionSummaryMaterializer } from '../../../session/summary/materialize.js'
 import { WorkspaceBackendRegistry } from '../../../session/workspace/registry.js'
 import { InMemorySessionStore } from '../../../store/session/memory.js'
@@ -24,7 +22,9 @@ import type { AgentTaskContext, SendMessageOptions } from '../../../types/agent/
 import type { AgentId, SessionId, TenantId, UserId } from '../../../types/ids/index.js'
 import { createAssistantMessage } from '../../../types/message/index.js'
 import type { RunEvent } from '../../../types/run/events.js'
+import type { ActorRef } from '../../../types/session/actor.js'
 import type { SummaryId, ThreadId } from '../../../types/session/ids.js'
+import type { DeliverableRef } from '../../../types/summary/deliverable.js'
 import { ZERO_COST } from '../../../utils/cost.js'
 import { ThreadManager } from '../../thread/lifecycle.js'
 import { AgentManager } from '../lifecycle.js'

package/src/manager/agent/lifecycle.ts

@@ -1,16 +1,11 @@
 import { AGENT_MANAGER_DEFAULTS } from '../../constants/agent/index.js'
 import { EMPTY_TOKEN_USAGE } from '../../constants/limits.js'
 import type { AgentRegistry } from '../../registry/agent/definitions.js'
-import { RUN_EVENT_SCHEMA_VERSION } from '../../session/events/schema-version.js'
 import {
 	type CapacityValidator,
 	DelegationCapacityExceeded,
 } from '../../session/handoff/capacity.js'
-import type { ActorRef } from '../../session/hierarchy/actor.js'
-import type { Lineage } from '../../session/hierarchy/lineage.js'
 import type { SessionSummaryMaterializer } from '../../session/summary/materialize.js'
-import type { SessionSummaryOutcome } from '../../session/summary/ref.js'
-import type { WorkspaceRef } from '../../session/workspace/ref.js'
 import type { WorkspaceBackendRegistry } from '../../session/workspace/registry.js'
 import type { BaseAgentConfig, BaseAgentResult } from '../../types/agent/base.js'
 import type {
@@ -28,8 +23,13 @@ import { isTerminalAgentTaskState } from '../../types/agent/task.js'
 import type { AgentId, RunId, SessionId, TaskId, TenantId } from '../../types/ids/index.js'
 import type { Message } from '../../types/message/index.js'
 import type { RunEvent, RunEventListener } from '../../types/run/events.js'
+import type { Lineage } from '../../types/run/lineage.js'
+import { RUN_EVENT_SCHEMA_VERSION } from '../../types/run/schema-version.js'
+import type { ActorRef } from '../../types/session/actor.js'
 import type { SubSessionId } from '../../types/session/ids.js'
 import type { SessionStore } from '../../types/session/store.js'
+import type { SessionSummaryOutcome } from '../../types/summary/ref.js'
+import type { WorkspaceRef } from '../../types/workspace/ref.js'
 import { createChildAbortController } from '../../utils/abort.js'
 import { ZERO_COST } from '../../utils/cost.js'
 import { toErrorMessage } from '../../utils/error.js'

package/src/manager/run/persistence.ts

@@ -4,14 +4,14 @@ import { type CostInfo, type TokenUsage, accumulateTokenUsage } from '../../type
 import type { RunId, SessionId, TenantId } from '../../types/ids/index.js'
 import type { AssistantMessage, Message } from '../../types/message/index.js'
 import type { EmergencySaveData } from '../../types/run/emergency.js'
-import type { AgentRun, RunPersistenceConfig, StopReason } from '../../types/run/index.js'
+import type { Run, RunPersistenceConfig, StopReason } from '../../types/run/index.js'
 import type { ProjectId, ThreadId } from '../../types/session/ids.js'
 import { type ModelPricing, ZERO_COST, accumulateCost } from '../../utils/cost.js'
 import { generateEmergencySaveId } from '../../utils/id.js'
 import type { Logger } from '../../utils/logger.js'
 
 export class RunPersistence {
-	private run: AgentRun
+	private run: Run
 	private runStore: RunDiskStore
 	private pricing?: ModelPricing
 	private log: Logger
@@ -96,11 +96,11 @@ export class RunPersistence {
 		return this.run.currentIteration
 	}
 
-	getRun(): Readonly<AgentRun> {
+	getRun(): Readonly<Run> {
 		return this.run
 	}
 
-	getSession(): Readonly<AgentRun> {
+	getSession(): Readonly<Run> {
 		return this.run
 	}
 

package/src/manager/thread/__tests__/lifecycle.test.ts

@@ -1,9 +1,9 @@
 import { describe, expect, it } from 'vitest'
 import { ThreadClosedError, ThreadNotEmptyError } from '../../../session/errors.js'
-import type { ActorRef } from '../../../session/hierarchy/actor.js'
 import { InMemorySessionStore } from '../../../store/session/memory.js'
 import { InMemoryThreadStore } from '../../../store/thread/memory.js'
 import type { AgentId, TenantId, UserId } from '../../../types/ids/index.js'
+import type { ActorRef } from '../../../types/session/actor.js'
 import type { ThreadId } from '../../../types/session/ids.js'
 import { ThreadManager } from '../lifecycle.js'
 

package/src/manager/thread/lifecycle.ts

@@ -25,11 +25,11 @@ import {
 	ThreadClosedError,
 	ThreadNotEmptyError,
 } from '../../session/errors.js'
-import type { Session, SessionStatus } from '../../session/hierarchy/session.js'
-import type { Thread } from '../../session/hierarchy/thread.js'
 import type { TenantId } from '../../types/ids/index.js'
+import type { Session, SessionStatus } from '../../types/session/entity.js'
 import type { ProjectId, ThreadId } from '../../types/session/ids.js'
 import type { SessionStore } from '../../types/session/store.js'
+import type { Thread } from '../../types/thread/entity.js'
 import type { CreateThreadParams, ThreadStore } from '../../types/thread/store.js'
 
 export interface ThreadManagerDeps {

package/src/plugin/loader.ts

@@ -3,7 +3,6 @@ import { homedir } from 'node:os'
 import { join } from 'node:path'
 import {
 	PLUGIN_MANIFEST_FILENAME,
-	PLUGIN_NAME_PATTERN,
 	PROJECT_PLUGIN_DIR,
 	USER_PLUGIN_DIR,
 } from '../constants/plugin/index.js'
@@ -53,21 +52,6 @@ export async function loadPluginManifest(pluginDir: string): Promise<PluginManif
 	return PluginManifestSchema.parse(parsed)
 }
 
-/**
- * Validates that the plugin name matches the directory name
- * and conforms to the plugin name pattern.
- */
-export function validatePluginName(name: string, dirName: string): void {
-	if (!PLUGIN_NAME_PATTERN.test(name)) {
-		throw new Error(
-			`Plugin name "${name}" is invalid. Must be lowercase alphanumeric with hyphens (pattern: ${PLUGIN_NAME_PATTERN.source})`,
-		)
-	}
-	if (name !== dirName) {
-		throw new Error(`Plugin name "${name}" must match directory name "${dirName}"`)
-	}
-}
-
 /**
  * Discovers plugin directories from both project-level and user-level locations.
  * Returns categorized arrays of absolute paths.