@namzu/sdk 58.1.1 → 60.0.0

package/src/types/tool/index.ts

@@ -173,6 +173,8 @@ export interface BackgroundJobRegistryRef {
 		status: string
 		exitCode?: number
 		error?: string
+		/** When it last wrote output (epoch ms); absent until it has. */
+		lastOutputAt?: number
 	}
 	/**
 	 * Take over a process the caller already started and is waiting on, so a
@@ -224,7 +226,19 @@ export interface BackgroundJobRegistryRef {
 		kind?: 'monitor'
 		/** What a monitor watches. */
 		description?: string
+		/** When the job started (epoch ms). Optional for hosts that do not keep it. */
+		startedAt?: number
+		/** When it last wrote output (epoch ms); absent until it has. */
+		lastOutputAt?: number
+		/** Its last non-empty output line, flattened and clipped. */
+		lastOutputLine?: string
 	}[]
+	/**
+	 * Whether the job's process is still there, asked of the system rather than
+	 * taken from the record. Optional: a host that cannot probe omits it, and a
+	 * running job is then reported as alive on the registry's word.
+	 */
+	isAlive?(id: string): boolean
 	/**
 	 * 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
@@ -259,6 +273,13 @@ export interface BackgroundJobRegistryRef {
 	 * intent, and then there is simply no hold.
 	 */
 	markAwaited?(id: string): void
+	/**
+	 * Say that this job's exit and output have just been handed to the model by
+	 * a tool result (`wait_for_job` returning the exit, `job` read of a stopped
+	 * job), so the exit notice that would announce the same exit is withdrawn
+	 * instead of repeating it. Optional for the reason `markAwaited` is.
+	 */
+	markCollected?(id: string): void
 }
 
 /**
@@ -514,6 +535,15 @@ export interface ToolContext {
 	 * directory; an absolute path inside any of these is accepted.
 	 */
 	additionalDirectories?: readonly string[]
+	/**
+	 * Whether the session's read rules deny an absolute path. The search tools
+	 * (`grep`, `glob`) call it for every file they would list or open and skip
+	 * a denied one, so a search over a folder holding a denied file succeeds
+	 * without showing or reading it. The executor supplies it from the turn's
+	 * authorization gate (what the `read` tool would be told for that path);
+	 * absent, no rules apply.
+	 */
+	readDenied?: (absolutePath: string) => boolean
 	/**
 	 * Absolute path of the directory holding THIS session's retained tool
 	 * output (the files an oversized result was saved to). The `read` tool may

package/src/types/tool/presentation.ts

@@ -175,6 +175,10 @@ export type ToolFacts =
 			readonly filesMatched?: number
 			readonly filesSearched?: number
 			readonly truncated?: boolean
+			/** A page or result cap cut the list; more results exist. */
+			readonly limited?: boolean
+			/** The search stopped before every file was examined. */
+			readonly incomplete?: boolean
 	  }
 	| {
 			readonly kind: 'list'
@@ -182,6 +186,10 @@ export type ToolFacts =
 			readonly path?: string
 			readonly count?: number
 			readonly truncated?: boolean
+			/** A result cap cut the list; more files match. */
+			readonly limited?: boolean
+			/** The search stopped before every file was examined. */
+			readonly incomplete?: boolean
 	  }
 	| {
 			readonly kind: 'edit'