@namzu/sdk 52.1.0 → 52.3.0

package/src/types/tool/index.ts

@@ -1,5 +1,6 @@
 import type { ChildProcess } from 'node:child_process'
 import type { z } from 'zod'
+import type { CodeAnalysisProvider } from '../code-analysis/index.js'
 import type { CodeNavigationProvider } from '../code-navigation/index.js'
 // Type-only, and circular by design: a tool-result guardrail is described in
 // terms of the tool that produced the result, and the registry that holds
@@ -119,6 +120,21 @@ export interface BackgroundJobRegistryRef {
 		id: string
 		status: string
 	}
+	/**
+	 * Start a command whose stdout lines reach the model as events while it
+	 * runs, and which is stopped at `timeoutMs`. The host clamps the timeout to
+	 * its own ceiling and the clamped value comes back, so the caller reports
+	 * the deadline that will actually fire. Optional, like `adopt`: a host that
+	 * cannot deliver events must omit it, and the `monitor` tool then refuses
+	 * rather than start a watch nobody will hear from. Throws when the owner is
+	 * at its job cap.
+	 */
+	startMonitor?(params: {
+		command: string
+		description: string
+		timeoutMs: number
+		workingDirectory?: string
+	}): { job: { id: string; status: string }; timeoutMs: number }
 	get(id: string): {
 		id: string
 		status: string
@@ -155,7 +171,15 @@ export interface BackgroundJobRegistryRef {
 		error?: string
 	}
 	kill(id: string): Promise<{ id: string; status: string }>
-	list(): readonly { id: string; command: string; status: string }[]
+	list(): readonly {
+		id: string
+		command: string
+		status: string
+		/** `monitor` for a job the `monitor` tool started. */
+		kind?: 'monitor'
+		/** What a monitor watches. */
+		description?: string
+	}[]
 	/**
 	 * Await this job's exit instead of reading it in a loop; resolves at
 	 * once for a job that has already stopped. Optional, and added after
@@ -465,6 +489,14 @@ export interface ToolContext {
 	 * always says "unavailable" is worse than one that is not there.
 	 */
 	codeNavigation?: CodeNavigationProvider
+	/**
+	 * A semantic index of JavaScript/TypeScript, for the `code_analysis` tool.
+	 *
+	 * Same rule as `codeNavigation`: absent means the tool is not registered,
+	 * so a tool that is always present and always says "unavailable" never
+	 * exists. See `tools/builtins/code-analysis.ts`.
+	 */
+	codeAnalysis?: CodeAnalysisProvider
 	fileReadTracker?: FileReadTracker
 
 	/**