@namzu/sdk 63.0.0 → 64.0.0

package/src/types/plugin/index.ts

@@ -246,12 +246,36 @@ export interface PluginModelResponse {
 
 /** What a compaction hook is shown about the pass. */
 export interface PluginCompactionInfo {
-	/** `threshold`: the estimate crossed the line. `overflow`: the provider rejected the prompt. */
-	readonly reason: 'threshold' | 'overflow'
+	/**
+	 * `threshold`: the estimate crossed the line. `overflow`: the provider
+	 * rejected the prompt. `manual`: a host asked for the pass outside a turn
+	 * (a person's `/compact`, a summarised span, an idle pass); test `trigger`
+	 * to tell a person's request from the kernel's own.
+	 */
+	readonly reason: 'threshold' | 'overflow' | 'manual'
 	readonly tokensBefore: number
 	/** Present on `post_compact`. */
 	readonly tokensAfter?: number
 	readonly contextWindowTokens: number
+	/**
+	 * Who started the pass: `manual` for one a person asked for (`/compact`,
+	 * summarising a span), `auto` for every pass the kernel or a host started
+	 * on its own (the threshold, a provider overflow, an idle pass). The
+	 * kernel always sets it; it is optional only so a host that builds this
+	 * context by hand keeps compiling. A matcher on these two events tests it.
+	 */
+	readonly trigger?: 'manual' | 'auto'
+	/**
+	 * On `pre_compact`: what the person typed with the command, or `null` when
+	 * they typed nothing or the pass is not one a person asked for.
+	 */
+	readonly instructions?: string | null
+	/**
+	 * On `post_compact`: the summary the pass wrote, cut to
+	 * `MAX_COMPACTION_SUMMARY_HOOK_CHARS`. Absent when the pass wrote none (a
+	 * context reducer shed the history, or the pass shed nothing).
+	 */
+	readonly summary?: string
 }
 
 /** One call in a `post_tool_batch` hook's context. */
@@ -275,19 +299,22 @@ export interface PluginNotificationInfo {
 }
 
 /**
- * Why a session started, on `session_start`: `startup` for a conversation
+ * Why a conversation began, on `session_start`: `startup` for a conversation
  * with no earlier turn, `resume` for one that already had turns (a resumed
- * conversation, a `--continue`, or a session rebuilt under a running one).
+ * conversation, a `--continue`, a fork, or a session rebuilt under a running
+ * one), `clear` for the empty conversation a host opens when the person
+ * clears the old one (`/clear`, `/new`).
  */
-export type PluginSessionSource = 'startup' | 'resume'
+export type PluginSessionSource = 'startup' | 'resume' | 'clear'
 
 /**
- * Why a session closed, on `session_end`: `exit` when the host is finishing
- * with it (the process ends, the person quits), `replaced` when the host
- * builds another session in its place (a model or account switch, another
- * conversation opened).
+ * Why a conversation ended, on `session_end`: `exit` when the host is
+ * finishing with it (the process ends, the person quits), `replaced` when the
+ * host moves to another session or conversation in its place (a model or
+ * account switch, another conversation opened or forked), `clear` when the
+ * person cleared it and a new, empty conversation begins (`/clear`, `/new`).
  */
-export type PluginSessionEndReason = 'exit' | 'replaced'
+export type PluginSessionEndReason = 'exit' | 'replaced' | 'clear'
 
 export interface PluginHookContext {
 	/** The turn the hook fired in. Absent on `session_start` and `session_end`. */
@@ -311,6 +338,14 @@ export interface PluginHookContext {
 	/** The pass, on `pre_compact` and `post_compact`. */
 	readonly compaction?: PluginCompactionInfo
 	readonly toolName?: string
+	/**
+	 * The id of the call, on `pre_tool_use`, `post_tool_use`,
+	 * `post_tool_use_failure`, `permission_request` and `permission_denied`: the
+	 * same id `post_tool_batch` carries as `toolCallId`, so a hook can pair a
+	 * before with an after. Absent on a call a tool makes through
+	 * `dispatchTool` (it has no model-issued id).
+	 */
+	readonly toolCallId?: string
 	readonly toolInput?: unknown
 	readonly toolResult?: ToolResult
 	/** The calls of one model step with their outcomes, on `post_tool_batch`. */
@@ -328,6 +363,13 @@ export interface PluginHookContext {
 	 * keep the model working until the turn's own limits stop it.
 	 */
 	readonly stopHookActive?: boolean
+	/**
+	 * On `turn_end` and `subagent_stop`: the text of the model's last message
+	 * of the turn, cut to `MAX_LAST_MESSAGE_HOOK_CHARS`. Absent when the turn
+	 * produced no text (it ended on a tool call, was interrupted before the
+	 * model wrote anything, or failed).
+	 */
+	readonly lastAssistantMessage?: string
 	readonly iteration?: number
 	/**
 	 * Why the turn was stopped, on `turn_interrupt`.
@@ -501,18 +543,20 @@ export type PluginHookResultFor<E extends PluginHookEvent> = E extends 'user_pro
 					? Extract<PluginHookResult, { action: 'continue' | 'error' }>
 					: E extends 'permission_request'
 						? Extract<PluginHookResult, { action: 'continue' | 'skip' }>
-						: E extends 'turn_end' | 'subagent_stop' | 'pre_compact'
-							? Extract<PluginHookResult, { action: 'continue' | 'skip' | 'error' }>
-							: E extends 'session_start'
-								? Extract<PluginHookResult, { action: 'continue' | 'annotate' }>
-								: E extends
-											| 'turn_interrupt'
-											| 'session_end'
-											| 'notification'
-											| 'turn_failure'
-											| 'permission_denied'
-									? Extract<PluginHookResult, { action: 'continue' }>
-									: Extract<PluginHookResult, { action: 'continue' | 'error' }>
+						: E extends 'pre_compact'
+							? Extract<PluginHookResult, { action: 'continue' | 'annotate' | 'skip' | 'error' }>
+							: E extends 'turn_end' | 'subagent_stop'
+								? Extract<PluginHookResult, { action: 'continue' | 'skip' | 'error' }>
+								: E extends 'session_start'
+									? Extract<PluginHookResult, { action: 'continue' | 'annotate' }>
+									: E extends
+												| 'turn_interrupt'
+												| 'session_end'
+												| 'notification'
+												| 'turn_failure'
+												| 'permission_denied'
+										? Extract<PluginHookResult, { action: 'continue' }>
+										: Extract<PluginHookResult, { action: 'continue' | 'error' }>
 
 /** The event and its handler verdict stay correlated, including in hook arrays. */
 export type PluginHookDefinition<E extends PluginHookEvent = PluginHookEvent> =

package/src/types/session/events.ts

@@ -435,6 +435,8 @@ type CoreSessionEvent =
 			message: string
 			/** Optional completion in [0,1] when the tool genuinely knows it. */
 			fraction?: number
+			/** Lines of output the call has produced so far, when the tool counts them (a shell command). Cumulative: the newest report wins. */
+			outputLines?: number
 	  }
 	/** Provider-executed activity, retained as evidence rather than a local tool request. */
 	| {

package/src/types/tool/index.ts

@@ -940,7 +940,13 @@ export interface ToolContext {
 	 *
 	 * Absent when the executing surface has no event stream to write to.
 	 */
-	report?: (message: string, fraction?: number) => void
+	report?: (message: string, fraction?: number, details?: ToolProgressDetails) => void
+}
+
+/** Facts a tool can attach to a progress report besides its words. */
+export interface ToolProgressDetails {
+	/** Lines of output the call has produced so far, counted by the tool itself (never by a renderer from what it was shown). */
+	readonly outputLines?: number
 }
 
 export interface ToolResult {
@@ -1009,6 +1015,13 @@ export interface ToolResult {
 	 * the child's turn fails with {@link ToolHandoff.reason} instead.
 	 */
 	handoff?: ToolHandoff
+	/**
+	 * This call only started work that goes on after it returned (a sub-agent
+	 * launched in the background, or one whose wait was released): the call itself
+	 * changed nothing. The turn's outcome record does not count it as a call that
+	 * may have changed files; what the started work does is its own record.
+	 */
+	launched?: true
 	/**
 	 * What this call did, as typed fields for the PERSON's view: the exit code
 	 * and the two streams of a command, the path and size of a read, whether a