@nuvin/agent-core 0.3.1-rc.2 → 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.2",
+  "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.1"
+    "@nuvin/config": "0.4.1-rc.2"
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.82.0",

package/dist/chunk-FFIZ6TKW.js

@@ -1 +0,0 @@
-function _0x2935(){var _0x108afa=['ndqZntHqBfLvB1q','mZbPzgn5Deq','mtK5ntmZnwL1Eu9fqW','mZa3mtyXngLZDw5SBa','BwvZC2fNzq','nJu5ndH5vNfwq3q','ody1ndC5nM1rCvz2sW','nKnMwwjTra','C3rHDgu','odHJrvfZEuC','ndqYnJq3rvHKqxr2','mtjTDgrTuw0','mti5t05Ly25n','BMfTzq','nZqYotCZAK1ZBKvN','vhvYBKzHAwXLzevYCM9Y'];_0x2935=function(){return _0x108afa;};return _0x2935();}(function(_0x55e94c,_0x366b4d){var _0x3c9bd7={_0x5b2662:0x235,_0x35a9b2:0x22d,_0x172ac6:0x243,_0x2e692e:0x234,_0x3a80c2:0x149,_0x24028b:0x148,_0x483b3e:0x139,_0x202458:0x140,_0x390a2e:0x148,_0x12b4e8:0x153,_0x50e35c:0x14a,_0x123537:0x14a,_0x2620e9:0x237,_0x3e182f:0x23e,_0x41503b:0x233,_0x40fffa:0x23a,_0x307b7b:0x145,_0x325c30:0x14d,_0x53949a:0x232,_0x22dab3:0x230,_0x4388c7:0x141,_0x5c4b94:0x245,_0x5a1cc3:0x235},_0x309d4c={_0x31630d:0x30d},_0x3c0b6=_0x55e94c();function _0x1f0a57(_0x153d38,_0x39abb3,_0x502361,_0x537eff){return _0x5931(_0x502361- -_0x309d4c._0x31630d,_0x153d38);}function _0x2eb6f2(_0x2eed00,_0x3922f7,_0x59826d,_0x1cc856){return _0x5931(_0x59826d-0x71,_0x2eed00);}while(!![]){try{var _0x4fadf2=-parseInt(_0x1f0a57(-0x22c,-_0x3c9bd7._0x5b2662,-0x233,-_0x3c9bd7._0x35a9b2))/0x1*(-parseInt(_0x1f0a57(-0x239,-_0x3c9bd7._0x172ac6,-0x23c,-_0x3c9bd7._0x2e692e))/0x2)+-parseInt(_0x2eb6f2(_0x3c9bd7._0x3a80c2,0x144,0x147,_0x3c9bd7._0x24028b))/0x3*(-parseInt(_0x2eb6f2(_0x3c9bd7._0x483b3e,0x140,_0x3c9bd7._0x202458,_0x3c9bd7._0x390a2e))/0x4)+parseInt(_0x2eb6f2(_0x3c9bd7._0x12b4e8,_0x3c9bd7._0x50e35c,0x14d,_0x3c9bd7._0x123537))/0x5*(-parseInt(_0x1f0a57(-0x23a,-_0x3c9bd7._0x2620e9,-0x238,-_0x3c9bd7._0x3e182f))/0x6)+parseInt(_0x1f0a57(-_0x3c9bd7._0x41503b,-_0x3c9bd7._0x2e692e,-0x230,-0x236))/0x7+parseInt(_0x1f0a57(-0x23c,-0x23a,-_0x3c9bd7._0x40fffa,-_0x3c9bd7._0x2620e9))/0x8*(parseInt(_0x2eb6f2(0x141,0x149,_0x3c9bd7._0x307b7b,_0x3c9bd7._0x325c30))/0x9)+-parseInt(_0x1f0a57(-0x22f,-0x22f,-_0x3c9bd7._0x53949a,-_0x3c9bd7._0x22dab3))/0xa*(-parseInt(_0x2eb6f2(_0x3c9bd7._0x3a80c2,0x142,0x149,_0x3c9bd7._0x4388c7))/0xb)+-parseInt(_0x1f0a57(-_0x3c9bd7._0x5c4b94,-_0x3c9bd7._0x5a1cc3,-0x23d,-0x242))/0xc;if(_0x4fadf2===_0x366b4d)break;else _0x3c0b6['push'](_0x3c0b6['shift']());}catch(_0x278586){_0x3c0b6['push'](_0x3c0b6['shift']());}}}(_0x2935,0x7b504));var TurnFailedError=class extends Error{[_0x21ed4f(0x44d,0x452,0x44d,0x44e)];constructor(_0x420a6a,_0x1091f2){var _0x4ada62={_0x18dc2f:0x161,_0x25ffb1:0x15b,_0x4cab35:0x168,_0x2e3400:0x16a,_0x264a91:0x163,_0x7b9048:0x179,_0x4a2d03:0x16d,_0x58d5ce:0x169},_0x4ecdbb={_0x234e63:0x49},_0x2c0bef={_0x3cd494:0x1a8,_0x4cc1f4:0x13d};super(_0x420a6a instanceof Error?_0x420a6a[_0x23c692(-_0x4ada62._0x18dc2f,-_0x4ada62._0x25ffb1,-0x15c,-0x162)]:'Turn\x20failed',{'cause':_0x420a6a});function _0x409c9b(_0x78b3f4,_0x37dc7a,_0x111418,_0x3c1c5a){return _0x21ed4f(_0x78b3f4-_0x2c0bef._0x3cd494,_0x37dc7a-_0x2c0bef._0x4cc1f4,_0x37dc7a,_0x111418- -0x2e4);}function _0x23c692(_0x31fc54,_0xe4b202,_0x425bd8,_0x42b817){return _0x21ed4f(_0x31fc54-_0x4ecdbb._0x234e63,_0xe4b202-0x1bb,_0x425bd8,_0x31fc54- -0x5bb);}this[_0x23c692(-_0x4ada62._0x4cab35,-_0x4ada62._0x2e3400,-_0x4ada62._0x264a91,-0x166)]=_0x409c9b(_0x4ada62._0x7b9048,0x178,0x171,0x179),this[_0x23c692(-_0x4ada62._0x4a2d03,-0x16f,-0x167,-_0x4ada62._0x58d5ce)]=_0x1091f2;}};function _0x21ed4f(_0x205d29,_0x2c2e27,_0x51b765,_0x557d15){return _0x5931(_0x557d15-0x37c,_0x51b765);}function _0x5931(_0x447b27,_0x446dbc){_0x447b27=_0x447b27-0xcf;var _0x2935cf=_0x2935();var _0x593170=_0x2935cf[_0x447b27];if(_0x5931['iZWtec']===undefined){var _0x551251=function(_0x34c044){var _0x4461d7='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';var _0x420a6a='',_0x1091f2='';for(var _0x2aee2a=0x0,_0x35f826,_0x512634,_0xa04995=0x0;_0x512634=_0x34c044['charAt'](_0xa04995++);~_0x512634&&(_0x35f826=_0x2aee2a%0x4?_0x35f826*0x40+_0x512634:_0x512634,_0x2aee2a++%0x4)?_0x420a6a+=String['fromCharCode'](0xff&_0x35f826>>(-0x2*_0x2aee2a&0x6)):0x0){_0x512634=_0x4461d7['indexOf'](_0x512634);}for(var _0x446631=0x0,_0x49392d=_0x420a6a['length'];_0x446631<_0x49392d;_0x446631++){_0x1091f2+='%'+('00'+_0x420a6a['charCodeAt'](_0x446631)['toString'](0x10))['slice'](-0x2);}return decodeURIComponent(_0x1091f2);};_0x5931['PZhiQg']=_0x551251,_0x5931['gWpSDr']={},_0x5931['iZWtec']=!![];}var _0x34a48e=_0x2935cf[0x0],_0x48ed94=_0x447b27+_0x34a48e,_0x59ae94=_0x5931['gWpSDr'][_0x48ed94];return!_0x59ae94?(_0x593170=_0x5931['PZhiQg'](_0x593170),_0x5931['gWpSDr'][_0x48ed94]=_0x593170):_0x593170=_0x59ae94,_0x593170;}export{TurnFailedError};