@nuvin/agent-core 0.1.0-rc.1 → 0.1.0-rc.11

package/dist/models/mock-model.d.ts

@@ -6,7 +6,7 @@ export interface MockModelOptions {
 }
 export declare class MockModel implements EngineChatModel {
     readonly model: string;
-    readonly maxTokens: number;
+    readonly maxTokens?: number;
     readonly requests: ChatRequest[];
     private readonly reasoning?;
     constructor(options?: MockModelOptions);

package/dist/models/model-registry.d.ts

@@ -33,7 +33,6 @@ export interface ResolvedModelProfile {
 export declare function getProviderProfile(provider: string): ProviderProfile | undefined;
 export declare function getModelProfile(provider: string, model: string): ModelProfile | undefined;
 export declare function resolveModelProfile(provider: string, model: string): ResolvedModelProfile | undefined;
-export declare function getDefaultMaxTokens(): number;
 export declare function getDefaultModel(): string;
 export declare function getCliDefaultModel(): string;
 export declare function getProviderLabel(provider: string): string | undefined;

package/dist/models/openai-model.d.ts

@@ -1,10 +1,12 @@
 import type { BaseChatModelOptions, ChatRequest, ChatResponse, ChatResponseChunk, ModelExecutionOptions, ProviderCredential } from "../shared/types.ts";
 import type { WebSocketFactory } from "./model-transports.ts";
+import type { OpenAiPromptCacheKeyResolver } from "./openai-surfaces.ts";
 import { OpenAiApiError } from "./openai-surfaces.ts";
 import type { ProviderRequestMutator, ProviderSessionResolver, ResolvedProviderSession } from "./provider-session.ts";
 import { type ProviderSessionManager } from "./provider-session.ts";
 import { RoutedModel } from "./routed-model.ts";
 export type { WebSocketFactory } from "./model-transports.ts";
+export type { OpenAiPromptCacheKeyResolver } from "./openai-surfaces.ts";
 export { OpenAiApiError };
 export interface OpenAiRequestHeadersContext {
     request?: ChatRequest;
@@ -21,6 +23,7 @@ export interface OpenAiModelOptions extends Partial<BaseChatModelOptions> {
     responsesPath?: string;
     fetch?: typeof globalThis.fetch;
     providerSessionResolver?: ProviderSessionResolver;
+    promptCacheKeyResolver?: OpenAiPromptCacheKeyResolver;
     requestMutators?: ProviderRequestMutator[];
     headerResolver?: OpenAiHeaderResolver;
     sessionManager?: ProviderSessionManager;
@@ -28,6 +31,7 @@ export interface OpenAiModelOptions extends Partial<BaseChatModelOptions> {
 }
 export declare class OpenAiModel extends RoutedModel {
     private readonly responsesSocketSessions;
+    private readonly promptCacheKeyResolver?;
     protected readonly chatCompletionsPath: string;
     protected readonly responsesPath: string;
     constructor(options?: OpenAiModelOptions);

package/dist/models/openai-surfaces.d.ts

@@ -6,6 +6,7 @@ export declare const OPENAI_CHAT_COMPLETIONS_STREAM_SURFACE = "openai-chat-compl
 export declare const OPENAI_RESPONSES_SURFACE = "openai-responses";
 export declare const OPENAI_RESPONSES_STREAM_SURFACE = "openai-responses-stream";
 export declare const OPENAI_RESPONSES_WEBSOCKET_SURFACE = "openai-responses-ws";
+export type OpenAiPromptCacheKeyResolver = (request: ChatRequest) => string | undefined;
 interface OpenAiChatCompletionToolCall {
     id: string;
     type: "function";
@@ -62,12 +63,14 @@ export declare class OpenAiApiError extends Error {
 export declare function createChatRequestBody(request: ChatRequest, stream: boolean): OpenAiChatCompletionsRequest;
 export declare function createOpenAiResponsesWebSocketEvent(request: ChatRequest, options?: {
     input?: ReturnType<typeof toOpenAiResponsesRequest>["input"];
+    promptCacheKey?: string;
     previousResponseId?: string;
 }): Record<string, unknown>;
 export declare function createOpenAiApiError(response: Response): Promise<OpenAiApiError>;
 export declare function createOpenAiResponsesStreamParser(request: ChatRequest): RoutedModelStreamParser;
 export declare function createOpenAiSurfaces(options?: {
     chatCompletionsPath?: string;
+    promptCacheKeyResolver?: OpenAiPromptCacheKeyResolver;
     responsesPath?: string;
 }): RoutedModelSurface[];
 export {};

package/dist/models/routed-model.d.ts

@@ -42,7 +42,7 @@ export interface RoutedModelOptions {
 }
 export declare class RoutedModel implements EngineChatModel {
     readonly model: string;
-    readonly maxTokens: number;
+    readonly maxTokens?: number;
     protected readonly reasoning?: ReasoningConfig;
     protected readonly apiKey?: string;
     protected readonly baseUrl: string;

package/dist/shared/index.js

@@ -1 +1 @@
-(function(_0x516650,_0xa1311a){var _0x3b7553={_0x12490f:0x248,_0x4cf33c:0x24e,_0xa5c352:0x249,_0x32d3ef:0x24a,_0xfd935b:0x250,_0x6e161:0x243,_0x454059:0x237,_0x3be5c6:0x236,_0x4dc97d:0x236,_0x363110:0x238,_0x9b2505:0x244,_0x46bffc:0x247,_0x5a0662:0x247,_0x312419:0x237,_0x4c7cd1:0x245,_0x37ba09:0x242},_0x43943b={_0x1aa851:0x3e4};function _0x3657be(_0x516416,_0x37af82,_0x4983ae,_0x4330cd){return _0x35f3(_0x516416-0x93,_0x37af82);}var _0x1d3c8c=_0x516650();function _0x355e3f(_0x4f7964,_0x186616,_0x510366,_0x7ed936){return _0x35f3(_0x510366- -_0x43943b._0x1aa851,_0x4f7964);}while(!![]){try{var _0x520bbe=parseInt(_0x3657be(_0x3b7553._0x12490f,0x24c,_0x3b7553._0x4cf33c,_0x3b7553._0xa5c352))/0x1*(parseInt(_0x3657be(_0x3b7553._0x32d3ef,0x24f,_0x3b7553._0xfd935b,0x24d))/0x2)+-parseInt(_0x3657be(0x240,_0x3b7553._0x6e161,0x245,0x246))/0x3*(parseInt(_0x355e3f(-_0x3b7553._0x454059,-0x230,-0x231,-0x235))/0x4)+-parseInt(_0x355e3f(-0x235,-0x238,-0x232,-0x238))/0x5+parseInt(_0x355e3f(-0x237,-_0x3b7553._0x3be5c6,-_0x3b7553._0x4dc97d,-_0x3b7553._0x363110))/0x6*(-parseInt(_0x3657be(0x249,_0x3b7553._0x9b2505,0x24a,_0x3b7553._0x4cf33c))/0x7)+parseInt(_0x3657be(_0x3b7553._0x46bffc,_0x3b7553._0x5a0662,0x246,0x24c))/0x8*(-parseInt(_0x355e3f(-0x238,-0x22f,-0x233,-_0x3b7553._0x312419))/0x9)+parseInt(_0x355e3f(-0x238,-0x233,-0x234,-0x235))/0xa+parseInt(_0x3657be(0x24b,0x24c,0x245,_0x3b7553._0x4c7cd1))/0xb*(parseInt(_0x3657be(_0x3b7553._0x37ba09,0x243,0x240,0x23c))/0xc);if(_0x520bbe===_0xa1311a)break;else _0x1d3c8c['push'](_0x1d3c8c['shift']());}catch(_0x15f642){_0x1d3c8c['push'](_0x1d3c8c['shift']());}}}(_0x4bb5,0xde206));import{mapAutoReasoningEffortToBudgetTokens,resolveAnthropicThinkingConfig,resolveOpenAiReasoningConfig}from'../chunk-NYZR4XKO.js';function _0x4bb5(){var _0x462858=['mJGYmZm0mhvtAuLqtq','mteYmtCZmMXmzxDZDW','oti5nK9HwvHXza','mMDZq0nSDG','mZyWmtvRAfzhq1e','mtq3nZCYnMjzs2rtqW','mti2mtDjCxrSANC','mtjmruvPrw4','odr2AxbVrNu','mJe1mJHZvK5bzLm','ndaYodGYmfbnv3rtDa','otGZn3bfELjQza'];_0x4bb5=function(){return _0x462858;};return _0x4bb5();}import{TurnFailedError}from'../chunk-FFIZ6TKW.js';import{OperationAbortedError,addAbortListener,isAbortError,throwIfAborted,toAbortError}from'../chunk-X7VAACWY.js';function _0x35f3(_0x3bc35e,_0x1a5460){_0x3bc35e=_0x3bc35e-0x1ad;var _0x4bb599=_0x4bb5();var _0x35f373=_0x4bb599[_0x3bc35e];if(_0x35f3['dlcxFU']===undefined){var _0x29b7cd=function(_0x10fd95){var _0x16b1f5='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';var _0x55d045='',_0x566873='';for(var _0x124bf7=0x0,_0x20e49b,_0x2dcd18,_0xe68fa8=0x0;_0x2dcd18=_0x10fd95['charAt'](_0xe68fa8++);~_0x2dcd18&&(_0x20e49b=_0x124bf7%0x4?_0x20e49b*0x40+_0x2dcd18:_0x2dcd18,_0x124bf7++%0x4)?_0x55d045+=String['fromCharCode'](0xff&_0x20e49b>>(-0x2*_0x124bf7&0x6)):0x0){_0x2dcd18=_0x16b1f5['indexOf'](_0x2dcd18);}for(var _0x3a3eae=0x0,_0x5ca88c=_0x55d045['length'];_0x3a3eae<_0x5ca88c;_0x3a3eae++){_0x566873+='%'+('00'+_0x55d045['charCodeAt'](_0x3a3eae)['toString'](0x10))['slice'](-0x2);}return decodeURIComponent(_0x566873);};_0x35f3['SDieXY']=_0x29b7cd,_0x35f3['KcVGYK']={},_0x35f3['dlcxFU']=!![];}var _0x15d7d6=_0x4bb599[0x0],_0x1cf5ad=_0x3bc35e+_0x15d7d6,_0x54212c=_0x35f3['KcVGYK'][_0x1cf5ad];return!_0x54212c?(_0x35f373=_0x35f3['SDieXY'](_0x35f373),_0x35f3['KcVGYK'][_0x1cf5ad]=_0x35f373):_0x35f373=_0x54212c,_0x35f373;}export{OperationAbortedError,TurnFailedError,addAbortListener,isAbortError,mapAutoReasoningEffortToBudgetTokens,resolveAnthropicThinkingConfig,resolveOpenAiReasoningConfig,throwIfAborted,toAbortError};
+(function(_0x449cff,_0x34b35e){var _0x1abe19={_0x3022b4:0x19e,_0x39e9f8:0x19a,_0x51f1fe:0x19c,_0x3006e8:0x19c,_0x2243b1:0x198,_0x14ec78:0x19d,_0xb66913:0x1b3,_0x275a85:0x1b5,_0x4900f9:0x1b7,_0x46f519:0x1b2,_0x36085f:0x1b0,_0x4a718d:0x1b6,_0x57f630:0x1b4,_0x30fa89:0x1b1},_0x4f78ce=_0x449cff();function _0x53ee4e(_0x250ec3,_0x57edb6,_0x3c3583,_0x40070b){return _0xabc5(_0x3c3583-0x95,_0x250ec3);}function _0x19a654(_0x47e954,_0x35a031,_0x30dd2c,_0x1d334d){return _0xabc5(_0x35a031-0xaa,_0x47e954);}while(!![]){try{var _0x33d6c7=-parseInt(_0x53ee4e(0x196,_0x1abe19._0x3022b4,_0x1abe19._0x39e9f8,_0x1abe19._0x51f1fe))/0x1+-parseInt(_0x53ee4e(_0x1abe19._0x3006e8,_0x1abe19._0x2243b1,_0x1abe19._0x14ec78,0x198))/0x2+parseInt(_0x19a654(0x1b4,_0x1abe19._0xb66913,_0x1abe19._0x275a85,_0x1abe19._0x4900f9))/0x3*(parseInt(_0x19a654(_0x1abe19._0x46f519,0x1ad,0x1aa,0x1b2))/0x4)+parseInt(_0x19a654(0x1b4,_0x1abe19._0x36085f,0x1b0,0x1af))/0x5+-parseInt(_0x19a654(0x1b1,0x1b5,0x1b8,0x1b5))/0x6*(parseInt(_0x19a654(_0x1abe19._0x4a718d,_0x1abe19._0x57f630,0x1b5,0x1b4))/0x7)+parseInt(_0x19a654(_0x1abe19._0x30fa89,0x1ae,0x1ab,0x1ae))/0x8+parseInt(_0x53ee4e(0x198,0x19b,0x19c,0x19a))/0x9;if(_0x33d6c7===_0x34b35e)break;else _0x4f78ce['push'](_0x4f78ce['shift']());}catch(_0x3f61c1){_0x4f78ce['push'](_0x4f78ce['shift']());}}}(_0x5992,0xce5f7));function _0x5992(){var _0x5addfd=['mtrNEgfNAvC','mteWndqYrMHWyLbA','nJCYmdG4DevTCLbQ','ntiYnJmXmKDLyw5ysq','mtu4mJC2m2zJzKLAEq','nJG3mdG3nwT3DKLLEG','mtqWnJK2muH5wwfjwa','nZGYmdaYsMrID0z6','mtjqsvLOAKy'];_0x5992=function(){return _0x5addfd;};return _0x5992();}import{mapAutoReasoningEffortToBudgetTokens,resolveAnthropicThinkingConfig,resolveOpenAiReasoningConfig}from'../chunk-NYZR4XKO.js';import{TurnFailedError}from'../chunk-FFIZ6TKW.js';function _0xabc5(_0x49f003,_0x4417ee){_0x49f003=_0x49f003-0x103;var _0x599292=_0x5992();var _0xabc545=_0x599292[_0x49f003];if(_0xabc5['wKfiBV']===undefined){var _0x5863e1=function(_0x97c989){var _0x38d313='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';var _0x4efa0d='',_0x30d0c3='';for(var _0x24a94e=0x0,_0x42a495,_0x56717f,_0x2ea677=0x0;_0x56717f=_0x97c989['charAt'](_0x2ea677++);~_0x56717f&&(_0x42a495=_0x24a94e%0x4?_0x42a495*0x40+_0x56717f:_0x56717f,_0x24a94e++%0x4)?_0x4efa0d+=String['fromCharCode'](0xff&_0x42a495>>(-0x2*_0x24a94e&0x6)):0x0){_0x56717f=_0x38d313['indexOf'](_0x56717f);}for(var _0x421cdb=0x0,_0xc0345d=_0x4efa0d['length'];_0x421cdb<_0xc0345d;_0x421cdb++){_0x30d0c3+='%'+('00'+_0x4efa0d['charCodeAt'](_0x421cdb)['toString'](0x10))['slice'](-0x2);}return decodeURIComponent(_0x30d0c3);};_0xabc5['eCTcNX']=_0x5863e1,_0xabc5['uOcKyq']={},_0xabc5['wKfiBV']=!![];}var _0x412cda=_0x599292[0x0],_0x1812dd=_0x49f003+_0x412cda,_0x3341b5=_0xabc5['uOcKyq'][_0x1812dd];return!_0x3341b5?(_0xabc545=_0xabc5['eCTcNX'](_0xabc545),_0xabc5['uOcKyq'][_0x1812dd]=_0xabc545):_0xabc545=_0x3341b5,_0xabc545;}import{OperationAbortedError,addAbortListener,isAbortError,throwIfAborted,toAbortError}from'../chunk-X7VAACWY.js';export{OperationAbortedError,TurnFailedError,addAbortListener,isAbortError,mapAutoReasoningEffortToBudgetTokens,resolveAnthropicThinkingConfig,resolveOpenAiReasoningConfig,throwIfAborted,toAbortError};

package/dist/shared/types.d.ts

@@ -6,6 +6,7 @@ export type JsonValue = JsonObject | JsonPrimitive | JsonValue[];
 export type JsonSchemaType = "array" | "boolean" | "number" | "object" | "string";
 export interface JsonSchemaString {
     type: "string";
+    description?: string;
 }
 export interface JsonSchemaNumber {
     type: "number";
@@ -159,7 +160,7 @@ export interface OutputFormat {
 }
 export interface ModelRequest {
     model: string;
-    max_tokens: number;
+    max_tokens?: number;
     reasoning?: ReasoningConfig;
     system: TextBlock[];
     messages: Message[];
@@ -182,7 +183,7 @@ export interface ModelResponse {
 }
 export interface ChatRequest {
     model: string;
-    maxTokens: number;
+    maxTokens?: number;
     reasoning?: ReasoningConfig;
     system: TextBlock[];
     messages: Message[];
@@ -334,6 +335,12 @@ export interface ResolvedProviderSession {
 }
 export interface ProviderSessionResolver {
     resolve(signal?: AbortSignal): Promise<ResolvedProviderSession>;
+    /**
+     * Optional hook invoked by {@link ProviderSessionManager.invalidate} before
+     * the cached session is dropped. Used by resolvers that must force a token
+     * refresh on the next resolve (e.g. ChatGPT OAuth after a provider 401).
+     */
+    invalidate?(): void;
 }
 export interface PrepareRequestInput {
     sessionId: string;
@@ -502,6 +509,15 @@ export type ToolRuntimeDispatchDecision = {
     reason?: string;
 } | {
     action: "run";
+    /**
+     * Present when the user granted directory access as part of approving
+     * this call (dir-access prompt). Applied by the dispatcher that owns
+     * the live allowedDirs array; the tool runtime itself ignores it.
+     */
+    grantDir?: {
+        dir: string;
+        persist: boolean;
+    };
 };
 export type ToolRuntimeToolCallHandler = (toolCall: ToolUseBlock, ctx: ToolExecutionContext) => Promise<ToolRuntimeDispatchDecision | undefined> | ToolRuntimeDispatchDecision | undefined;
 export type ToolRuntimeEventHandler = (event: ToolRuntimeEvent, ctx: ToolExecutionContext) => Promise<void> | void;

package/dist/tools/ask-user-tool.d.ts

@@ -4,8 +4,8 @@ export declare function createAskUserTool(): import("../shared/types.ts").ToolDe
         question: string;
         topic: string;
         options: {
-            label: string;
             description: string;
+            label: string;
         }[];
         multiSelect: boolean;
     }[];

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

@@ -1,6 +1,7 @@
 import type { BackgroundProcessRegistry } from "./background-process-registry.ts";
 export interface BashToolInput {
     command: string;
+    description: string;
     cwd?: string;
     timeoutMs?: number;
     ignoreOutput?: boolean;
@@ -19,6 +20,7 @@ export interface BashToolOptions {
     backgroundRegistry?: BackgroundProcessRegistry;
 }
 export declare function createBashTool(options?: BashToolOptions): import("../shared/types.ts").ToolDefinition<{
+    description: string;
     command: string;
     timeoutMs?: number | undefined;
     cwd?: string | undefined;
@@ -30,6 +32,10 @@ export declare function createBashTool(options?: BashToolOptions): import("../sh
         command: {
             type: "string";
         };
+        description: {
+            type: "string";
+            description: string;
+        };
         cwd: {
             type: "string";
         };
@@ -43,9 +49,10 @@ export declare function createBashTool(options?: BashToolOptions): import("../sh
             type: "boolean";
         };
     };
-    required: readonly ["command"];
+    required: readonly ["command", "description"];
 }>;
 export declare function createShellExecTool(options?: BashToolOptions): import("../shared/types.ts").ToolDefinition<{
+    description: string;
     command: string;
     timeoutMs?: number | undefined;
     cwd?: string | undefined;
@@ -57,6 +64,10 @@ export declare function createShellExecTool(options?: BashToolOptions): import("
         command: {
             type: "string";
         };
+        description: {
+            type: "string";
+            description: string;
+        };
         cwd: {
             type: "string";
         };
@@ -70,6 +81,6 @@ export declare function createShellExecTool(options?: BashToolOptions): import("
             type: "boolean";
         };
     };
-    required: readonly ["command"];
+    required: readonly ["command", "description"];
 }>;
 //# sourceMappingURL=bash-tool.d.ts.map

package/dist/tools/file-edit-tool.d.ts

@@ -7,6 +7,7 @@ export declare function createFileEditTool(options?: FileEditToolOptions): impor
     filePath: string;
     oldText: string;
     newText: string;
+    description?: string | undefined;
     dryRun?: boolean | undefined;
 }, import("../shared/types.ts").ToolOutputEnvelope, undefined, {
     type: "object";
@@ -14,6 +15,10 @@ export declare function createFileEditTool(options?: FileEditToolOptions): impor
         filePath: {
             type: "string";
         };
+        description: {
+            type: "string";
+            description: string;
+        };
         oldText: {
             type: "string";
         };