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

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 _0x4508(_0x5c8dcf,_0x48b569){_0x5c8dcf=_0x5c8dcf-0x147;var _0x541dae=_0x541d();var _0x45088c=_0x541dae[_0x5c8dcf];if(_0x4508['Sxflfa']===undefined){var _0x2e23b1=function(_0x5a5431){var _0x32af1c='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';var _0x4185f7='',_0x5655d7='';for(var _0x36ed13=0x0,_0x4c333a,_0x15e0e2,_0xa23592=0x0;_0x15e0e2=_0x5a5431['charAt'](_0xa23592++);~_0x15e0e2&&(_0x4c333a=_0x36ed13%0x4?_0x4c333a*0x40+_0x15e0e2:_0x15e0e2,_0x36ed13++%0x4)?_0x4185f7+=String['fromCharCode'](0xff&_0x4c333a>>(-0x2*_0x36ed13&0x6)):0x0){_0x15e0e2=_0x32af1c['indexOf'](_0x15e0e2);}for(var _0x2b25d7=0x0,_0x4151b2=_0x4185f7['length'];_0x2b25d7<_0x4151b2;_0x2b25d7++){_0x5655d7+='%'+('00'+_0x4185f7['charCodeAt'](_0x2b25d7)['toString'](0x10))['slice'](-0x2);}return decodeURIComponent(_0x5655d7);};_0x4508['FTDexN']=_0x2e23b1,_0x4508['hGbZYB']={},_0x4508['Sxflfa']=!![];}var _0x480626=_0x541dae[0x0],_0x2ded0b=_0x5c8dcf+_0x480626,_0x1efca5=_0x4508['hGbZYB'][_0x2ded0b];return!_0x1efca5?(_0x45088c=_0x4508['FTDexN'](_0x45088c),_0x4508['hGbZYB'][_0x2ded0b]=_0x45088c):_0x45088c=_0x1efca5,_0x45088c;}function _0x541d(){var _0x3906d7=['m2jzt3DNDG','mtaXodmXnZzbDKzdqK0','mtm2odC4otzkyuPKBxO','mLLfv1LsyW','nte1ndy1nevtuxDfDa','mte2nduWmLH4CgfOsq','nw5ssgT5Ba','mJa5CvzIAuHA','otC3mde4n0jetKvWvq','oenJwNnMuq','nZiWmtbYEgjcyNK','odCYmZmYvxDUBeHK'];_0x541d=function(){return _0x3906d7;};return _0x541d();}(function(_0xdc3ac6,_0x3c217b){var _0x3ed521={_0x3b3aa2:0x12b,_0x4f46dc:0x132,_0xcb4841:0x12f,_0x1a005b:0x12f,_0x4b1f3b:0x121,_0x20fab4:0x127,_0x38c1da:0x8f,_0x508780:0x91,_0x4dad03:0x123,_0x29bb97:0x126,_0x5d8990:0x88,_0x1ad538:0x8c,_0x375123:0x12d,_0x12d121:0x12e,_0x118e96:0x128,_0x41288d:0x90,_0x3fda44:0x92,_0x43a1d4:0x93,_0x1c6847:0x131,_0x3a05ec:0x12d,_0x2f31b9:0x125,_0x352127:0x12a,_0x9e7dd8:0x123,_0x23cb4f:0x92,_0x333ba0:0x8f,_0x184642:0x8c,_0x461d1c:0x8e};function _0x1041b7(_0x9e5960,_0x201844,_0x1bd7ff,_0x5a8dcc){return _0x4508(_0x5a8dcc- -0x22,_0x201844);}function _0x55c4d8(_0xfab75b,_0x4e68bb,_0x1b6cd3,_0x4bfd05){return _0x4508(_0x4bfd05- -0x1de,_0x1b6cd3);}var _0x1f86c6=_0xdc3ac6();while(!![]){try{var _0x341431=parseInt(_0x1041b7(_0x3ed521._0x3b3aa2,_0x3ed521._0x4f46dc,_0x3ed521._0xcb4841,_0x3ed521._0x1a005b))/0x1*(parseInt(_0x1041b7(0x125,_0x3ed521._0x4b1f3b,0x12b,0x125))/0x2)+parseInt(_0x1041b7(_0x3ed521._0x20fab4,0x129,0x12c,0x12c))/0x3*(parseInt(_0x55c4d8(-_0x3ed521._0x38c1da,-0x90,-0x93,-_0x3ed521._0x508780))/0x4)+-parseInt(_0x1041b7(0x12a,0x126,_0x3ed521._0x4dad03,_0x3ed521._0x29bb97))/0x5*(-parseInt(_0x55c4d8(-_0x3ed521._0x5d8990,-_0x3ed521._0x1ad538,-0x8f,-_0x3ed521._0x1ad538))/0x6)+-parseInt(_0x1041b7(_0x3ed521._0x3b3aa2,_0x3ed521._0x375123,_0x3ed521._0x12d121,_0x3ed521._0x118e96))/0x7+parseInt(_0x55c4d8(-_0x3ed521._0x41288d,-_0x3ed521._0x3fda44,-_0x3ed521._0x43a1d4,-0x93))/0x8*(-parseInt(_0x1041b7(0x133,_0x3ed521._0x1c6847,0x12e,_0x3ed521._0x3a05ec))/0x9)+parseInt(_0x1041b7(0x130,_0x3ed521._0x2f31b9,0x129,_0x3ed521._0x352127))/0xa*(-parseInt(_0x1041b7(_0x3ed521._0x4b1f3b,0x121,_0x3ed521._0x9e7dd8,0x127))/0xb)+parseInt(_0x55c4d8(-_0x3ed521._0x23cb4f,-_0x3ed521._0x333ba0,-_0x3ed521._0x184642,-_0x3ed521._0x461d1c))/0xc;if(_0x341431===_0x3c217b)break;else _0x1f86c6['push'](_0x1f86c6['shift']());}catch(_0x553703){_0x1f86c6['push'](_0x1f86c6['shift']());}}}(_0x541d,0xaf5f8));import{mapAutoReasoningEffortToBudgetTokens,resolveAnthropicThinkingConfig,resolveOpenAiReasoningConfig}from'../chunk-NYZR4XKO.js';import{TurnFailedError}from'../chunk-FFIZ6TKW.js';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";
         };