@namzu/sdk 34.2.0 → 35.0.0

package/src/connector/tools/definitions.ts

@@ -2,7 +2,7 @@ import { z } from 'zod'
 import type { ConnectorManager } from '../../manager/connector/lifecycle.js'
 import { defineTool } from '../../tools/defineTool.js'
 import type { ToolDefinition } from '../../types/tool/index.js'
-import { parseConnectorInstanceId } from '../../utils/id.js'
+import { asConnectorInstanceId } from '../../utils/id.js'
 import { connectorToolError } from './result.js'
 
 export interface ConnectorToolConfig {
@@ -30,7 +30,7 @@ export function createConnectorExecuteTool(config: ConnectorToolConfig): ToolDef
 		concurrencySafe: true,
 
 		async execute(input, context) {
-			const instanceId = parseConnectorInstanceId(String(input.instance_id))
+			const instanceId = asConnectorInstanceId(String(input.instance_id))
 			const instance = config.manager.getInstance(instanceId)
 
 			if (!instance) {

package/src/constants/compaction/index.ts

@@ -12,6 +12,7 @@ export const SHELL_TOOLS = new Set(['bash'])
 export const SEARCH_TOOLS = new Set(['glob', 'grep'])
 
 export const SECTION_HEADERS = {
+	pins: '## Pinned by tools',
 	task: '## Task',
 	userRequirements: '## User Requirements',
 	plan: '## Plan',

package/src/constants/telemetry/index.ts

@@ -146,7 +146,6 @@ export const BOOT_EVENT_NAMES = {
 	CAPABILITY_DETECTED: 'namzu.capability.detected',
 	CAPABILITY_BROKEN: 'namzu.capability.broken',
 	TELEMETRY_STATUS: 'namzu.telemetry.status',
-	MIGRATION_COMPLETED: 'namzu.migration.completed',
 	DISCOVERY_COMPLETED: 'namzu.discovery.completed',
 	BOOT_REFUSED: 'namzu.boot.refused',
 	BOOT_READY: 'namzu.boot.ready',

package/src/contracts/api.ts

@@ -1,6 +1,7 @@
 import type { AgentCapabilities, AgentType } from '../types/agent/base.js'
 import type { ProjectId, RunId, SessionId } from '../types/ids/index.js'
 import type { MessageRole } from '../types/message/index.js'
+import type { PermissionMode } from '../types/permission/index.js'
 import type { StopReason } from '../types/run/events.js'
 
 export type { MessageRole, StopReason, AgentType, AgentCapabilities }
@@ -106,7 +107,8 @@ export interface RunHierarchyNode {
 	children: RunHierarchyNode[]
 }
 
-export type ApiPermissionMode = 'plan' | 'auto'
+/** The wire name for the kernel's `PermissionMode`; one union, not a second copy of it. */
+export type ApiPermissionMode = PermissionMode
 
 export interface RunConfig {
 	model?: string
@@ -168,6 +170,8 @@ export type StreamEventType =
 	| 'compaction.completed'
 	/** Oversized tool results were emptied instead of the history summarized. */
 	| 'compaction.tool_results_cleared'
+	| 'memory.consolidated'
+	| 'background_job.exited'
 	| 'compaction.failed'
 	/** A guardrail refused or corrected the run. */
 	| 'guardrail.triggered'

package/src/contracts/schemas.ts

@@ -1,25 +1,11 @@
 import { z } from 'zod'
 
-/**
- * The two shapes the SDK mints, and nothing else.
- *
- * `prj_<12 lowercase alphanumerics>` comes from `generateProjectId()`.
- * `prj_legacy_<suffix>` comes from the v0.2.0 filesystem migration, which
- * synthesises a project per legacy `thd_*` folder. The `legacy_` segment is
- * spelled out rather than covered by a permissive character class, because a
- * project id is also a directory name: everything this accepts is joined to a
- * path, so the set it accepts is a containment boundary, not a formatting
- * preference.
- *
- * A host that supplies its own `SessionStore` and mints its own ids should
- * validate with its own schema — `ProjectId` is `prj_${string}` at the type
- * level and this schema is deliberately narrower.
- */
-export const ProjectIdSchema = z
-	.string()
-	.regex(/^prj_(legacy_)?[a-z0-9]+$/, 'Invalid project ID format')
-export const RunIdSchema = z.string().regex(/^run_[a-z0-9]+$/, 'Invalid run ID format')
-export const MessageIdSchema = z.string().regex(/^msg_[a-z0-9]+$/, 'Invalid message ID format')
+import { entityIdPattern } from '../utils/id-format.js'
+
+/** Shared with constructors and stores: opaque UUIDs. */
+export const ProjectIdSchema = z.string().regex(entityIdPattern(), 'Invalid project ID format')
+export const RunIdSchema = z.string().regex(entityIdPattern(), 'Invalid run ID format')
+export const MessageIdSchema = z.string().regex(entityIdPattern(), 'Invalid message ID format')
 
 export const RunConfigSchema = z
 	.object({

package/src/invariants/index.ts

@@ -18,7 +18,7 @@ import { ManagedRegistry } from '../registry/ManagedRegistry.js'
  * — no live run to point it at, a dependency not wired yet — is not the same
  * fact as a check that ran and found nothing wrong, and collapsing the two
  * turns "I do not know" into the strongest possible wrong answer. See
- * `docs/conventions/an-optional-dependency-may-not-degrade-a-check.md`.
+ * "an optional dependency may not degrade a check".
  */
 export type InvariantOutcome =
 	| { readonly state: 'holds' }