@nuvin/agent-core 0.3.1-rc.1 → 0.4.0-rc.3

package/dist/tools/shell/background-bash-controller.d.ts

@@ -1,5 +1,8 @@
 import type { ChildProcess } from "node:child_process";
+import type { BashArtifactCapture, BashArtifactPublication, BashArtifactRef } from "./bash-artifact.ts";
 export type BackgroundBashStartRequest = Readonly<{
+    toolCallId: string;
+    artifact: BashArtifactCapture;
     command: string;
     description: string;
     cwd: string;
@@ -9,6 +12,7 @@ export type BackgroundBashStartRequest = Readonly<{
 }>;
 export type BackgroundBashAttachInput = Readonly<{
     child: ChildProcess;
+    artifact: BashArtifactCapture;
     description: string;
     commandPreview: string;
     cwd: string;
@@ -18,6 +22,12 @@ export type BackgroundBashAttached = Readonly<{
     pid: number | null;
 }>;
 export type BackgroundBashTerminalResult = Readonly<{
+    bashArtifactVersion: 1;
+    artifact: BashArtifactPublication;
+    processStarted: boolean;
+    closeConfirmed: boolean;
+    terminationConfirmed: boolean;
+    finishedAt: number;
     status: "exited" | "killed" | "error";
     exitCode: number | null;
     signal: string | null;
@@ -31,7 +41,14 @@ export type BackgroundBashStartErrorCode = "background-start-cancelled" | "backg
 /** Stable detached-only start failure that never exposes provider or OS error text. */
 export declare class BackgroundBashStartError extends Error {
     readonly code: BackgroundBashStartErrorCode;
-    constructor(code: BackgroundBashStartErrorCode);
+    readonly correlation?: (BashArtifactRef & Readonly<{
+        shellId: string;
+        attemptId: string;
+    }>) | undefined;
+    constructor(code: BackgroundBashStartErrorCode, correlation?: (BashArtifactRef & Readonly<{
+        shellId: string;
+        attemptId: string;
+    }>) | undefined);
 }
 export type BackgroundBashInspection = Readonly<{
     description: string;
@@ -51,17 +68,6 @@ export type BackgroundBashInspection = Readonly<{
     forceRequested: boolean;
     errorCode?: string;
 }>;
-export type BackgroundBashReadResult = Readonly<{
-    shellId: string;
-    offset: number;
-    nextOffset: number;
-    output: string;
-    status: "running" | "exited" | "killed" | "error";
-    exitCode: number | null;
-    signal: string | null;
-    truncated: boolean;
-    totalDropped: number;
-}>;
 export type BackgroundBashTerminationResult = Readonly<{
     shellId: string;
     outcome: "killed" | "already-terminal" | "failed";
@@ -73,15 +79,12 @@ export type BackgroundBashTerminationResult = Readonly<{
     forceRequested: boolean;
 }>;
 export interface BackgroundBashController {
-    start(request: BackgroundBashStartRequest): Promise<Readonly<{
+    start(request: BackgroundBashStartRequest): Promise<BashArtifactRef & Readonly<{
         shellId: string;
+        attemptId: string;
         pid: number | null;
         status: "running";
     }>>;
-    read(request: Readonly<{
-        shellId: string;
-        offset?: number;
-    }>): Promise<BackgroundBashReadResult>;
     kill(shellId: string): Promise<BackgroundBashTerminationResult>;
 }
 //# sourceMappingURL=background-bash-controller.d.ts.map

package/dist/tools/shell/background-bash-process.d.ts

@@ -25,6 +25,8 @@ export declare class BackgroundBashProcessStore {
     terminate(workId: string, signalAdapter?: ProcessTreeSignalAdapter, forceIfUnconfirmed?: boolean): Promise<BackgroundBashTerminationResult>;
     release(workId: string): void;
     private requestTermination;
+    private requestSignal;
+    private classifyClose;
     private confirmed;
     private failed;
     private terminationResult;
@@ -36,14 +38,4 @@ export declare class BackgroundBashProcessStore {
     private evict;
     private entry;
 }
-export declare function filterBackgroundBashOutput(input: Readonly<{
-    output: string;
-    offset: number;
-    nextOffset: number;
-    status: "running" | "exited" | "killed" | "error";
-    regex?: string;
-}>): Readonly<{
-    output: string;
-    nextOffset: number;
-}>;
 //# sourceMappingURL=background-bash-process.d.ts.map

package/dist/tools/shell/bash-artifact.d.ts

@@ -0,0 +1,62 @@
+export declare const BASH_OUTPUT_MAX_BYTES = 67108864;
+export type BashArtifactOwner = Readonly<{
+    profile: string;
+    workspace: string;
+    sessionId: string;
+}>;
+export type BashArtifactDestination = Readonly<{
+    owner: BashArtifactOwner;
+    sessionDir: string;
+}>;
+export type BashExecutionState = "starting" | "running" | "terminating" | "exited" | "killed" | "error" | "abandoned";
+export type BashCaptureState = "capturing" | "complete" | "truncated" | "error" | "interrupted";
+export type BashArtifactRef = Readonly<{
+    artifactId: string;
+    outputPath: string;
+    statusPath: string;
+}>;
+export type BashExecutionSnapshot = Readonly<{
+    state: BashExecutionState;
+    exitCode: number | null;
+    signal: string | null;
+    errorCode: string | null;
+    finishedAt: number | null;
+}>;
+export type BashArtifactStatus = BashArtifactRef & BashExecutionSnapshot & Readonly<{
+    version: 1;
+    owner: BashArtifactOwner;
+    toolCallId: string;
+    shellId?: string;
+    captureState: BashCaptureState;
+    bytesRetained: number;
+    maxBytes: 67108864;
+    truncated: boolean;
+    captureErrorCode: string | null;
+    startedAt: number;
+    updatedAt: number;
+}>;
+export type BashArtifactPublication = Readonly<{
+    status: BashArtifactStatus;
+    statusErrorCode: string | null;
+}>;
+export interface BashArtifactCapture {
+    readonly ref: BashArtifactRef;
+    /** Pass per-stream decoded text in arrival order; pause that source until this
+     * resolves. One outstanding append per source bounds caller-owned input too.
+     * Capture failures/capping resolve normally so both pipes can keep draining. */
+    append(stream: "stdout" | "stderr", decoded: string): Promise<void>;
+    /** Stops admission, drains accepted appends and closes output; idempotent. */
+    flush(): Promise<void>;
+    /** Terminal snapshots require flush. Storage failure returns statusErrorCode;
+     * the disk file is then last-known, while status contains current memory facts. */
+    publish(execution: BashExecutionSnapshot, shellId?: string): Promise<BashArtifactPublication>;
+    /** Marks released unfinished capture abandoned, never claims an OS kill. */
+    interrupt(): Promise<BashArtifactPublication>;
+}
+export declare function isBashArtifactStatus(value: unknown): value is BashArtifactStatus;
+export declare function writeBashArtifactStatus(status: BashArtifactStatus): Promise<void>;
+export declare function createBashArtifact(input: Readonly<{
+    destination: BashArtifactDestination;
+    toolCallId: string;
+}>): Promise<BashArtifactCapture>;
+//# sourceMappingURL=bash-artifact.d.ts.map

package/dist/tools/shell/bash-tool.d.ts

@@ -1,5 +1,6 @@
 import type { BashExecutionTarget, ToolExecutionContext } from "../../shared/types.ts";
 import { type BackgroundBashController } from "./background-bash-controller.ts";
+import { type BashArtifactCapture, type BashArtifactDestination } from "./bash-artifact.ts";
 export interface BashToolInput {
     command: string;
     description: string;
@@ -21,9 +22,20 @@ export interface BashToolOptions {
     scrubEnvKeys?: readonly string[];
     scrubEnvPrefixes?: readonly string[];
     backgroundController?: BackgroundBashController;
-    verifyExecution?: (target: BashExecutionTarget, authorization: unknown, ctx: ToolExecutionContext) => Promise<void> | void;
+    artifactDestination?: () => BashArtifactDestination | undefined;
+    outputBudgetBytes?: number;
+    backgroundCapability?: "foreground-only" | "interactive-main";
+    trackForegroundExecution?: (execution: BashForegroundExecution) => void;
+    verifyExecution?: (target: BashExecutionTarget, authorization: unknown, ctx: ToolExecutionContext, phase?: "preflight" | "final") => Promise<void> | void;
 }
 export declare function resolveBashExecutionTarget(input: Pick<BashToolInput, "command" | "cwd" | "runInBackground">, options?: Pick<BashToolOptions, "allowedDirs" | "defaultCwd" | "shellPath">): BashExecutionTarget;
+export interface BashForegroundExecution {
+    readonly artifact: BashArtifactCapture;
+    /** Confirmed child close, capture flush, and final status publication. */
+    readonly settled: Promise<void>;
+    /** Bounded process-tree escalation; rejects when close cannot be confirmed. */
+    terminate(reason: unknown): Promise<void>;
+}
 export declare function createBashTool(options?: BashToolOptions): import("../../shared/types.ts").ToolDefinition<{
     description: string;
     command: string;
@@ -34,7 +46,11 @@ export declare function createBashTool(options?: BashToolOptions): import("../..
     outputRegex?: string | undefined;
 }, string, import("../../shared/types.ts").ToolOutputEnvelope, {
     type: "object";
+    additionalProperties: false;
     properties: {
+        runInBackground?: {
+            type: "boolean";
+        } | undefined;
         command: {
             type: "string";
         };
@@ -55,9 +71,6 @@ export declare function createBashTool(options?: BashToolOptions): import("../..
             type: "string";
             description: string;
         };
-        runInBackground: {
-            type: "boolean";
-        };
     };
     required: readonly ["command", "description"];
 }>;
@@ -71,7 +84,11 @@ export declare function createShellExecTool(options?: BashToolOptions): import("
     outputRegex?: string | undefined;
 }, string, import("../../shared/types.ts").ToolOutputEnvelope, {
     type: "object";
+    additionalProperties: false;
     properties: {
+        runInBackground?: {
+            type: "boolean";
+        } | undefined;
         command: {
             type: "string";
         };
@@ -92,9 +109,6 @@ export declare function createShellExecTool(options?: BashToolOptions): import("
             type: "string";
             description: string;
         };
-        runInBackground: {
-            type: "boolean";
-        };
     };
     required: readonly ["command", "description"];
 }>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuvin/agent-core",
-  "version": "0.3.1-rc.1",
+  "version": "0.4.0-rc.3",
   "private": false,
   "description": "Core agent, model, format, and tool primitives for Nuvin",
   "license": "Apache-2.0",
@@ -56,7 +56,7 @@
     "tsup": "^8.5.1",
     "typescript": "^6.0.2",
     "vitest": "^4.1.2",
-    "@nuvin/config": "0.4.1-rc.0"
+    "@nuvin/config": "0.4.1-rc.2"
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.82.0",

package/dist/chunk-FFIZ6TKW.js

@@ -1 +0,0 @@
-function _0x4fade2(_0x5bb97e,_0x21f8ed,_0xf353b8,_0x401387){return _0x5061(_0x401387-0xc0,_0x5bb97e);}function _0x4d09(){var _0x366574=['mtjHzvnREw0','nteZnJaWnxzdDgjOBq','ntG3mde5shv2A2Hw','BMfTzq','nZyWnJu3og9szwPIBq','mte3mJqWnM5QCvPRwa','otKWnJi0CKTdzM1y','C3rHDgu','nJC2mteYsfzoEu1q','vhvYBIbMywLSzwq','nwP1C1bHEG','nJyYmdq5mhr3vMz3tG','vhvYBKzHAwXLzevYCM9Y'];_0x4d09=function(){return _0x366574;};return _0x4d09();}function _0x5061(_0x187ac2,_0x290d2c){_0x187ac2=_0x187ac2-0xd9;var _0x4d09ed=_0x4d09();var _0x5061b4=_0x4d09ed[_0x187ac2];if(_0x5061['tVIGqm']===undefined){var _0x39bd5b=function(_0x19aca2){var _0x8c52cc='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';var _0x3c344e='',_0x4db073='';for(var _0x4b33a6=0x0,_0x4cdb0f,_0x40f2c0,_0x40f8e5=0x0;_0x40f2c0=_0x19aca2['charAt'](_0x40f8e5++);~_0x40f2c0&&(_0x4cdb0f=_0x4b33a6%0x4?_0x4cdb0f*0x40+_0x40f2c0:_0x40f2c0,_0x4b33a6++%0x4)?_0x3c344e+=String['fromCharCode'](0xff&_0x4cdb0f>>(-0x2*_0x4b33a6&0x6)):0x0){_0x40f2c0=_0x8c52cc['indexOf'](_0x40f2c0);}for(var _0xa5c81e=0x0,_0x454a9c=_0x3c344e['length'];_0xa5c81e<_0x454a9c;_0xa5c81e++){_0x4db073+='%'+('00'+_0x3c344e['charCodeAt'](_0xa5c81e)['toString'](0x10))['slice'](-0x2);}return decodeURIComponent(_0x4db073);};_0x5061['ipVhgw']=_0x39bd5b,_0x5061['wSrJno']={},_0x5061['tVIGqm']=!![];}var _0x812657=_0x4d09ed[0x0],_0x2af895=_0x187ac2+_0x812657,_0x2385e5=_0x5061['wSrJno'][_0x2af895];return!_0x2385e5?(_0x5061b4=_0x5061['ipVhgw'](_0x5061b4),_0x5061['wSrJno'][_0x2af895]=_0x5061b4):_0x5061b4=_0x2385e5,_0x5061b4;}(function(_0xb26911,_0x2230f4){var _0x349df0={_0x4e4cdb:0x72,_0x2033ea:0x76,_0x1b07a1:0x79,_0x54b343:0x75,_0x28128a:0x125,_0xef7d5a:0x11e,_0x56cc8:0x128,_0x31b9a1:0x120,_0x3de844:0x74,_0x20a2eb:0x70,_0x3baf5f:0x77,_0x7bbbc5:0x12a,_0x478d8a:0x125,_0x41e4af:0x124,_0x2ef723:0x11c,_0x302988:0x116,_0x250f06:0x6f},_0x4624f9={_0x3d99ae:0x41},_0xdc457e={_0x2f771a:0x152},_0x183e74=_0xb26911();function _0x8e068b(_0x7cc24a,_0x2ba1d1,_0xc3fe2a,_0x53366a){return _0x5061(_0x7cc24a- -_0xdc457e._0x2f771a,_0x53366a);}function _0x322d7c(_0xa2ef5e,_0x5c80bb,_0x40529e,_0x405c1e){return _0x5061(_0x405c1e-_0x4624f9._0x3d99ae,_0x40529e);}while(!![]){try{var _0x16eabf=parseInt(_0x8e068b(-0x78,-0x72,-_0x349df0._0x4e4cdb,-_0x349df0._0x2033ea))/0x1+parseInt(_0x8e068b(-_0x349df0._0x1b07a1,-_0x349df0._0x54b343,-0x79,-0x73))/0x2+parseInt(_0x322d7c(_0x349df0._0x28128a,0x124,_0x349df0._0xef7d5a,0x124))/0x3*(parseInt(_0x322d7c(_0x349df0._0x56cc8,_0x349df0._0x31b9a1,0x122,0x122))/0x4)+parseInt(_0x8e068b(-_0x349df0._0x3de844,-_0x349df0._0x20a2eb,-0x70,-_0x349df0._0x3baf5f))/0x5*(-parseInt(_0x322d7c(_0x349df0._0x7bbbc5,0x126,_0x349df0._0x478d8a,0x126))/0x6)+parseInt(_0x322d7c(_0x349df0._0x41e4af,0x121,_0x349df0._0x2ef723,0x123))/0x7+-parseInt(_0x322d7c(0x123,0x120,_0x349df0._0x302988,0x11d))/0x8+-parseInt(_0x8e068b(-0x73,-0x70,-_0x349df0._0x1b07a1,-_0x349df0._0x250f06))/0x9;if(_0x16eabf===_0x2230f4)break;else _0x183e74['push'](_0x183e74['shift']());}catch(_0x2e8f86){_0x183e74['push'](_0x183e74['shift']());}}}(_0x4d09,0xc5aca));var TurnFailedError=class extends Error{[_0x4fade2(0x19b,0x1a1,0x1a0,0x19b)];constructor(_0x3c344e,_0x4db073){var _0x594fb0={_0x235745:0x40c,_0x257f59:0x418,_0x1af9ee:0x41f,_0x473c50:0x41e,_0x552153:0x418,_0x2852f0:0x1d1,_0x51a09c:0x1d6,_0x54ea04:0x410,_0x31489b:0x411,_0x3f36cb:0x418,_0x526841:0x415},_0x2d68ec={_0x21e3df:0x1d5,_0xe23698:0x276},_0x21afa3={_0x487b95:0x13b};super(_0x3c344e instanceof Error?_0x3c344e['message']:_0x76b878(_0x594fb0._0x235745,0x413,_0x594fb0._0x235745,_0x594fb0._0x257f59),{'cause':_0x3c344e}),this[_0x76b878(_0x594fb0._0x1af9ee,0x41a,_0x594fb0._0x473c50,_0x594fb0._0x552153)]=_0x265c57(-_0x594fb0._0x2852f0,-_0x594fb0._0x51a09c,-0x1d5,-0x1d1);function _0x265c57(_0x44c0bd,_0x49876e,_0x1d4678,_0x46ce68){return _0x4fade2(_0x46ce68,_0x49876e-0xd3,_0x1d4678-_0x21afa3._0x487b95,_0x44c0bd- -0x371);}function _0x76b878(_0x503be1,_0x27b111,_0x174a4b,_0x28c83f){return _0x4fade2(_0x503be1,_0x27b111-0xd9,_0x174a4b-_0x2d68ec._0x21e3df,_0x27b111-_0x2d68ec._0xe23698);}this[_0x76b878(_0x594fb0._0x54ea04,_0x594fb0._0x31489b,_0x594fb0._0x3f36cb,_0x594fb0._0x526841)]=_0x4db073;}};export{TurnFailedError};