@nuvin/agent-core 0.1.0-rc.0 → 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(_0x359ba2,_0x1bfa38){var _0x383263={_0x195de7:0x190,_0x2b4fd:0x194,_0x25791b:0x47,_0x28d93e:0x3e,_0x2bf6e5:0x44,_0x1e5102:0x49,_0x2531b1:0x18b,_0x474321:0x18d,_0x307bb0:0x18e,_0x48192b:0x189,_0x3d398a:0x46,_0x4c4e0a:0x47},_0x2e99b3={_0x37f282:0x1eb},_0x46e5bc={_0x296ab7:0x15},_0x5a7361=_0x359ba2();function _0x16e9b5(_0x2dbfe0,_0x7fdbda,_0x29a43c,_0x281f21){return _0x12d9(_0x2dbfe0- -_0x46e5bc._0x296ab7,_0x29a43c);}function _0x547459(_0x16c061,_0x45800e,_0x38192f,_0x5acf68){return _0x12d9(_0x5acf68- -_0x2e99b3._0x37f282,_0x45800e);}while(!![]){try{var _0x458e8e=-parseInt(_0x16e9b5(_0x383263._0x195de7,0x190,_0x383263._0x2b4fd,0x18c))/0x1+-parseInt(_0x547459(-0x40,-_0x383263._0x25791b,-_0x383263._0x28d93e,-0x43))/0x2*(-parseInt(_0x547459(-_0x383263._0x2bf6e5,-0x49,-0x4d,-_0x383263._0x1e5102))/0x3)+parseInt(_0x16e9b5(_0x383263._0x2531b1,_0x383263._0x474321,0x18e,0x188))/0x4*(-parseInt(_0x16e9b5(_0x383263._0x307bb0,0x18a,0x191,0x18e))/0x5)+parseInt(_0x16e9b5(0x18c,0x191,_0x383263._0x48192b,_0x383263._0x48192b))/0x6+parseInt(_0x547459(-0x46,-0x45,-0x49,-0x45))/0x7+parseInt(_0x547459(-_0x383263._0x3d398a,-_0x383263._0x4c4e0a,-0x45,-0x47))/0x8+-parseInt(_0x547459(-0x44,-0x45,-0x48,-_0x383263._0x2bf6e5))/0x9;if(_0x458e8e===_0x1bfa38)break;else _0x5a7361['push'](_0x5a7361['shift']());}catch(_0x30d074){_0x5a7361['push'](_0x5a7361['shift']());}}}(_0x7d3c,0x3e099));import{mapAutoReasoningEffortToBudgetTokens,resolveAnthropicThinkingConfig,resolveOpenAiReasoningConfig}from'../chunk-NYZR4XKO.js';function _0x7d3c(){var _0x229a8b=['mJyYnZe4r0vcu1nV','mtGYntmYme9YANLHAa','mZqYmtu4nhHIz3f4zq','mtK2mdm4u3jztMDU','nJy4y0fMrgDg','mJa5mZiWog1zugPhvG','ouj0u1DzDW','mte3mdvLEvfyt1C','mZa3nda4oe1dC0H2Ba'];_0x7d3c=function(){return _0x229a8b;};return _0x7d3c();}import{TurnFailedError}from'../chunk-FFIZ6TKW.js';function _0x12d9(_0x3bdc7b,_0x247a58){_0x3bdc7b=_0x3bdc7b-0x1a0;var _0x7d3c55=_0x7d3c();var _0x12d959=_0x7d3c55[_0x3bdc7b];if(_0x12d9['PcldTZ']===undefined){var _0x2c1356=function(_0x411296){var _0x4249c6='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';var _0x105669='',_0x170a80='';for(var _0x4b46b1=0x0,_0xb02cb7,_0x506b1b,_0x4826fb=0x0;_0x506b1b=_0x411296['charAt'](_0x4826fb++);~_0x506b1b&&(_0xb02cb7=_0x4b46b1%0x4?_0xb02cb7*0x40+_0x506b1b:_0x506b1b,_0x4b46b1++%0x4)?_0x105669+=String['fromCharCode'](0xff&_0xb02cb7>>(-0x2*_0x4b46b1&0x6)):0x0){_0x506b1b=_0x4249c6['indexOf'](_0x506b1b);}for(var _0x53bd23=0x0,_0x14d96e=_0x105669['length'];_0x53bd23<_0x14d96e;_0x53bd23++){_0x170a80+='%'+('00'+_0x105669['charCodeAt'](_0x53bd23)['toString'](0x10))['slice'](-0x2);}return decodeURIComponent(_0x170a80);};_0x12d9['VKHuYF']=_0x2c1356,_0x12d9['FQDIgu']={},_0x12d9['PcldTZ']=!![];}var _0x568125=_0x7d3c55[0x0],_0x3f6a27=_0x3bdc7b+_0x568125,_0x468091=_0x12d9['FQDIgu'][_0x3f6a27];return!_0x468091?(_0x12d959=_0x12d9['VKHuYF'](_0x12d959),_0x12d9['FQDIgu'][_0x3f6a27]=_0x12d959):_0x12d959=_0x468091,_0x12d959;}import{OperationAbortedError,addAbortListener,isAbortError,throwIfAborted,toAbortError}from'../chunk-X7VAACWY.js';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;
@@ -356,8 +363,21 @@ export interface ChatModel {
 export interface ModelExecutionOptions {
     signal?: AbortSignal;
 }
+export interface TurnMessageMeta {
+    provider?: string;
+    model?: string;
+    /** ms epoch — provider request sent. */
+    turnStartedAt?: number;
+    /** ms epoch — response fully received. */
+    turnCompletedAt?: number;
+    /** ms epoch — first reasoning/thinking delta. */
+    reasoningStartedAt?: number;
+    /** ms epoch — reasoning settled (first assistant text / done). */
+    reasoningCompletedAt?: number;
+}
 export interface EngineChatModel {
     model: string;
+    provider?: string;
     maxTokens?: number;
     complete(request: ChatRequest, options?: ModelExecutionOptions): Promise<ChatResponse>;
     stream?(request: ChatRequest, options?: ModelExecutionOptions): AsyncIterable<ChatResponseChunk>;
@@ -489,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;
@@ -537,6 +566,8 @@ export interface PayloadByStage {
 }
 export interface ExtensionContext {
     state: TurnState;
+    /** Present only on the assistant-message `afterMessageAppend` run. */
+    turnMeta?: TurnMessageMeta;
 }
 export type Transformer<S extends TransformableStage> = (payload: PayloadByStage[S], ctx: ExtensionContext) => PayloadByStage[S] | Promise<PayloadByStage[S]>;
 export type Observer<S extends Stage> = (payload: PayloadByStage[S], ctx: ExtensionContext) => 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";
         };