veryfront 0.1.1237 → 0.1.1239

package/esm/src/agent/runtime/agent-runtime-step.d.ts

@@ -1,5 +1,7 @@
 import type { RemoteToolSource, ToolDefinition, ToolExecutionContext } from "../../tool/index.js";
-import type { AgentConfig, Message } from "../types.js";
+import type { ModelRuntime } from "../../provider/index.js";
+import type { AgentConfig, AgentSystem, Message } from "../types.js";
+import type { ChatSystemMessage } from "../../chat/types.js";
 import { type SkillToolAvailability } from "../../skill/allowed-tools.js";
 import type { ToolConfigEntry } from "./tool-helpers.js";
 import type { SourceIntegrationPolicyManifest } from "../../integrations/source-policy.js";
@@ -19,10 +21,10 @@ export type RuntimeStepToolLoader = (toolsConfig: true | Record<string, ToolConf
     callerAgentId?: string;
 }) => Promise<ToolDefinition[]>;
 export interface AgentRuntimeStepState {
-    systemPrompt: string;
+    systemPrompt: AgentSystem;
     context?: Record<string, unknown>;
 }
-export type RuntimeStepStateResolver = (messages: Message[], runtimeContext: Record<string, unknown> | undefined, mode: AgentRuntimeStepMode, step: number, systemPrompt: string) => Promise<AgentRuntimeStepState>;
+export type RuntimeStepStateResolver = (messages: Message[], runtimeContext: Record<string, unknown> | undefined, mode: AgentRuntimeStepMode, step: number, systemPrompt: AgentSystem, providerOptionKey: string | undefined) => Promise<AgentRuntimeStepState>;
 export interface PrepareAgentRuntimeStepInput {
     agentId: string;
     activeSkillId?: string | undefined;
@@ -30,19 +32,21 @@ export interface PrepareAgentRuntimeStepInput {
     allowedRemoteToolNames: string[] | undefined;
     config: AgentConfig;
     effectiveModel?: string;
+    modelRuntime?: ModelRuntime;
     excludedToolNames?: ReadonlySet<string>;
     forwardedRemoteToolDefinitions: ToolDefinition[] | undefined;
     getAvailableTools: RuntimeStepToolLoader;
     supportsToolCalling: boolean;
     messages: Message[];
     mode: AgentRuntimeStepMode;
+    providerOptionKey?: string;
     providerToolNames?: readonly string[];
     remoteToolSources: RemoteToolSource[] | undefined;
     sourceIntegrationPolicy?: SourceIntegrationPolicyManifest;
     resolveRuntimeState: RuntimeStepStateResolver;
     runtimeContext: Record<string, unknown> | undefined;
     step: number;
-    systemPrompt: string;
+    systemPrompt: AgentSystem;
     toolContextBase: ToolExecutionContext | undefined;
     strictConfiguredToolsOnly?: boolean;
     toolExposureState?: ToolExposureState;
@@ -51,12 +55,14 @@ export interface PrepareAgentRuntimeStepInput {
 export interface PreparedAgentRuntimeStep {
     integrationToolDiscovery?: RemoteIntegrationToolDiscoveryResult;
     runtimeContext: Record<string, unknown> | undefined;
-    systemPrompt: string;
+    systemPrompt: AgentSystem;
     toolContext: ToolExecutionContext;
     tools: ToolDefinition[];
     toolExposurePlan: ToolExposurePlan;
 }
 export declare function withIntegrationToolDiscoveryStatus(systemPrompt: string, discovery: RemoteIntegrationToolDiscoveryResult | undefined): string;
+export declare function withIntegrationToolDiscoveryStatus(systemPrompt: ChatSystemMessage[], discovery: RemoteIntegrationToolDiscoveryResult | undefined): ChatSystemMessage[];
+export declare function withIntegrationToolDiscoveryStatus(systemPrompt: AgentSystem, discovery: RemoteIntegrationToolDiscoveryResult | undefined): AgentSystem;
 /** Resolve per-step runtime state and the tools visible for that step. */
 export declare function prepareAgentRuntimeStep(input: PrepareAgentRuntimeStepInput): Promise<PreparedAgentRuntimeStep>;
 //# sourceMappingURL=agent-runtime-step.d.ts.map

package/esm/src/agent/runtime/agent-runtime-step.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-runtime-step.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/agent-runtime-step.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-runtime-step.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/agent-runtime-step.ts"],"names":[],"mappings":"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"}

package/esm/src/agent/runtime/agent-runtime-step.js

@@ -4,10 +4,11 @@ import { resolveRuntimeToolLoading, SOURCE_INTEGRATION_POLICY_CONTEXT_KEY, } fro
 import { createToolExposurePlan, createToolExposureState, restoreToolExposureState, } from "./tool-exposure.js";
 import { flattenSystemInstructions, hasRuntimeToolInventory, withRuntimeToolInventory, } from "./tool-inventory.js";
 import { getProviderToolProfile } from "./provider-tool-compat.js";
+import { resolveModelProviderOptionKey } from "./model-resolution.js";
 import { createProviderNativeToolExposureDefinitions } from "./provider-native-tool-inventory.js";
 const INTEGRATION_TOOL_DISCOVERY_STATUS_HEADER = "Integration tool discovery status:";
 const INTEGRATION_TOOL_DISCOVERY_STATUS_FOOTER = "End integration tool discovery status.";
-function removeIntegrationToolDiscoveryStatus(systemPrompt) {
+function removeIntegrationToolDiscoveryStatusText(systemPrompt) {
     let result = systemPrompt;
     while (true) {
         const headerIndex = result.indexOf(INTEGRATION_TOOL_DISCOVERY_STATUS_HEADER);
@@ -22,6 +23,15 @@ function removeIntegrationToolDiscoveryStatus(systemPrompt) {
         ].filter(Boolean).join("\n\n");
     }
 }
+function removeIntegrationToolDiscoveryStatus(systemPrompt) {
+    if (typeof systemPrompt === "string") {
+        return removeIntegrationToolDiscoveryStatusText(systemPrompt);
+    }
+    return systemPrompt.flatMap((message) => {
+        const content = removeIntegrationToolDiscoveryStatusText(message.content);
+        return content.length > 0 ? [{ ...message, content }] : [];
+    });
+}
 export function withIntegrationToolDiscoveryStatus(systemPrompt, discovery) {
     const basePrompt = removeIntegrationToolDiscoveryStatus(systemPrompt);
     let message;
@@ -32,7 +42,9 @@ export function withIntegrationToolDiscoveryStatus(systemPrompt, discovery) {
     if (!message)
         return basePrompt;
     const statusBlock = `${INTEGRATION_TOOL_DISCOVERY_STATUS_HEADER}\n\n${message}\n\n${INTEGRATION_TOOL_DISCOVERY_STATUS_FOOTER}`;
-    return basePrompt.length > 0 ? `${basePrompt}\n\n${statusBlock}` : statusBlock;
+    return typeof basePrompt === "string"
+        ? basePrompt.length > 0 ? `${basePrompt}\n\n${statusBlock}` : statusBlock
+        : [...basePrompt, { role: "system", content: statusBlock }];
 }
 function shouldIncludeSkillTools(config) {
     return config.skills !== false && (!Array.isArray(config.skills) || config.skills.length > 0);
@@ -46,7 +58,8 @@ function getTrustedAllowedSkillIds(input) {
 /** Resolve per-step runtime state and the tools visible for that step. */
 export async function prepareAgentRuntimeStep(input) {
     const trustedAllowedSkillIds = getTrustedAllowedSkillIds(input);
-    const runtimeState = await input.resolveRuntimeState(input.messages, input.runtimeContext, input.mode, input.step, input.systemPrompt);
+    const runtimeState = await input.resolveRuntimeState(input.messages, input.runtimeContext, input.mode, input.step, input.systemPrompt, input.providerOptionKey ??
+        resolveModelProviderOptionKey(input.effectiveModel ?? input.config.model, input.modelRuntime));
     const toolContext = { ...input.toolContextBase, ...runtimeState.context };
     if (input.toolContextBase?.abortSignal !== undefined) {
         toolContext.abortSignal = input.toolContextBase.abortSignal;
@@ -122,15 +135,19 @@ export async function prepareAgentRuntimeStep(input) {
         maxVisibleTools: getProviderToolProfile(input.effectiveModel ?? input.config.model).maxTools,
     });
     const baseSystemPrompt = removeIntegrationToolDiscoveryStatus(runtimeState.systemPrompt);
-    const systemPrompt = hasRuntimeToolInventory(baseSystemPrompt)
-        ? flattenSystemInstructions(withRuntimeToolInventory(baseSystemPrompt, toolExposurePlan.visible.map((tool) => tool.name), 
+    const instructionsWithToolInventory = hasRuntimeToolInventory(baseSystemPrompt)
+        ? withRuntimeToolInventory(baseSystemPrompt, toolExposurePlan.visible.map((tool) => tool.name), 
         // Naming what is deferred is the difference between a tool the model
         // can seek and one it has no reason to believe exists.
         toolExposurePlan.deferred.map((tool) => ({
             name: tool.name,
             description: tool.description,
-        }))))
+        })))
         : baseSystemPrompt;
+    const systemPrompt = typeof baseSystemPrompt === "string" &&
+        Array.isArray(instructionsWithToolInventory)
+        ? flattenSystemInstructions(instructionsWithToolInventory)
+        : instructionsWithToolInventory;
     return {
         integrationToolDiscovery,
         runtimeContext: trustedAllowedSkillIds === undefined

package/esm/src/agent/runtime/call-context.d.ts

@@ -2,8 +2,8 @@
  * Agent Call Context
  *
  * Assembles the complete system-message set for one provider call. Every
- * caller that talks to a model — the hosted cloud runtime, the project
- * runtime's internal agent runs, and the `agent()` factory — gathers its own
+ * caller that talks to a model, the hosted cloud runtime, the project
+ * runtime's internal agent runs, and the `agent()` factory, gathers its own
  * inputs and hands them here, so ordering, block tags, marker splitting,
  * deduplication, and skill rendering live in exactly one place.
  *
@@ -13,22 +13,24 @@
  *
  * Layout of the returned messages:
  *
- * 1. One cached system message holding, in order, the instructions before the
- *    runtime-context marker, `<project_instructions>`, `<project_context>`,
- *    any caller-supplied extra blocks, the instructions after the marker, and
- *    `<available_skills>`.
- * 2. An uncached `<environment_context>` message.
+ * 1. One cached system message holding only the instructions before the
+ *    runtime-context marker (or all instructions when the marker is absent).
+ * 2. One optional uncached system message holding, in order,
+ *    `<project_instructions>`, `<project_context>`, any caller-supplied extra
+ *    blocks, `<available_skills>` or an `<authorized_skill_ids>`
+ *    fallback, `<environment_context>`, and the instructions after the marker.
  *
  * Only the instructions are unconditional: each block appears only when the
  * caller supplied its input and the instructions do not already carry that tag
  * as a complete element, so message 2 can be absent and message 1 can be the
- * instructions alone. Callers compose in layers — the factory's output is later
- * re-composed by a project-runtime run — and skipping already-present elements
+ * instructions alone. Callers compose in layers: the factory's output is later
+ * re-composed by a project-runtime run, and skipping already-present elements
  * keeps that idempotent instead of repeating a project reference or catalog.
  *
  * @module
  */
 import type { ChatSystemMessage } from "../../chat/types.js";
+import type { AgentSystem } from "../types.js";
 import type { RuntimeSkillDefinition } from "./skill-metadata.js";
 /** Marker authored instructions use to place runtime blocks mid-prompt. */
 export declare const DEFAULT_RUNTIME_AGENT_CONTEXT_MARKER = "<!-- veryfront-runtime-context -->";
@@ -40,7 +42,7 @@ export type AgentCallProjectContext = {
 /** Input payload for build agent call context. */
 export type BuildAgentCallContextInput = {
     /** Agent instructions, optionally split by the runtime-context marker. */
-    instructions: string;
+    instructions: AgentSystem;
     /** Marker that places runtime blocks mid-prompt. Defaults to the shared marker. */
     runtimeContextMarker?: string;
     /** Steering text the host requires the agent to follow. */
@@ -53,11 +55,40 @@ export type BuildAgentCallContextInput = {
     skills?: readonly RuntimeSkillDefinition[];
     /** Host-supplied environment facts. */
     environmentContext?: string;
+    /**
+     * Prompt-cache TTL for the static (Layer 0) system message. `"5m"` (default)
+     * keeps the standard ephemeral breakpoint; `"1h"` extends it for interactive
+     * multi-turn sessions. Gate this at the call site. Only set `"1h"` during
+     * interactive run rendering where a second read is likely. Structured prompts
+     * keep their latest four Anthropic breakpoints when the final breakpoint is
+     * added. See RFC 0001.
+     */
+    cacheTtl?: AgentCallCacheTtl;
+    /**
+     * Active Anthropic provider alias whose structured cache metadata participates
+     * in TTL normalization. Defaults to the built-in `veryfront-cloud` alias.
+     */
+    anthropicProviderAlias?: string;
 };
+/** Supported prompt-cache TTLs for the cached static system message. */
+export type AgentCallCacheTtl = "5m" | "1h";
 /** Builds the shared project-context prompt block (project reference + branch). */
 export declare function buildProjectContextPromptBlock(input: AgentCallProjectContext): string;
 /** Builds the project-instructions prompt block. */
 export declare function buildProjectInstructionsPromptBlock(instructions: string): string;
-/** Builds the complete system-message set for one provider call. */
+/**
+ * Builds the layered system-message set for one provider call (RFC 0001).
+ *
+ * Layer 0 (cached, shared across runs): the agent prompt only, with nothing
+ * project- or turn-specific. Its `cacheControl` breakpoint is the sole shared
+ * cache key, so it must be byte-identical across projects.
+ *
+ * Dynamic tail (uncached): project context/instructions, extra blocks, the
+ * skills catalog, and host environment facts. This includes everything that varies by
+ * project, session, or turn. Kept out of the cached prefix so a fresh project
+ * or session still reads the shared Layer 0 instead of paying full price.
+ */
 export declare function buildAgentCallContext(input: BuildAgentCallContextInput): ChatSystemMessage[];
+/** Keeps the marker so another internal context composer can consume it. */
+export declare function buildAgentCallContextPreservingRuntimeMarker(input: BuildAgentCallContextInput): ChatSystemMessage[];
 //# sourceMappingURL=call-context.d.ts.map

package/esm/src/agent/runtime/call-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"call-context.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/call-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG7D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,2EAA2E;AAC3E,eAAO,MAAM,oCAAoC,uCAAuC,CAAC;AAKzF,gFAAgF;AAChF,MAAM,MAAM,uBAAuB,GAAG;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF,kDAAkD;AAClD,MAAM,MAAM,0BAA0B,GAAG;IACvC,0EAA0E;IAC1E,YAAY,EAAE,MAAM,CAAC;IACrB,mFAAmF;IACnF,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,2DAA2D;IAC3D,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,yDAAyD;IACzD,cAAc,CAAC,EAAE,uBAAuB,CAAC;IACzC,qFAAqF;IACrF,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,iDAAiD;IACjD,MAAM,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAC3C,uCAAuC;IACvC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,mFAAmF;AACnF,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,uBAAuB,GAAG,MAAM,CAcrF;AAED,oDAAoD;AACpD,wBAAgB,mCAAmC,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAKhF;AAoCD,oEAAoE;AACpE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,GAAG,iBAAiB,EAAE,CAgE5F"}
+{"version":3,"file":"call-context.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/call-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAQ/C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAWlE,2EAA2E;AAC3E,eAAO,MAAM,oCAAoC,uCAAuC,CAAC;AAOzF,gFAAgF;AAChF,MAAM,MAAM,uBAAuB,GAAG;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF,kDAAkD;AAClD,MAAM,MAAM,0BAA0B,GAAG;IACvC,0EAA0E;IAC1E,YAAY,EAAE,WAAW,CAAC;IAC1B,mFAAmF;IACnF,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,2DAA2D;IAC3D,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,yDAAyD;IACzD,cAAc,CAAC,EAAE,uBAAuB,CAAC;IACzC,qFAAqF;IACrF,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,iDAAiD;IACjD,MAAM,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAC3C,uCAAuC;IACvC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B;;;OAGG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC,CAAC;AAEF,wEAAwE;AACxE,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,IAAI,CAAC;AAE5C,mFAAmF;AACnF,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,uBAAuB,GAAG,MAAM,CAcrF;AAED,oDAAoD;AACpD,wBAAgB,mCAAmC,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAKhF;AA+fD;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,GAAG,iBAAiB,EAAE,CA4H5F;AAOD,4EAA4E;AAC5E,wBAAgB,4CAA4C,CAC1D,KAAK,EAAE,0BAA0B,GAChC,iBAAiB,EAAE,CAKrB"}