@roll-agent/runtime 0.27.0 → 1.0.1

package/dist/tool-bridge/transcript-tool.d.ts

@@ -7,47 +7,19 @@ import { type ToolExecutionCoordinator } from "./tool-execution-coordinator.ts";
 export declare const TRANSCRIPT_TOOL_AGENT_NAME = "roll";
 export declare const TRANSCRIPT_TOOL_NAME = "transcript";
 export declare const TRANSCRIPT_TOOL_ID = "roll__transcript";
-declare const transcriptToolInputSchema: z.ZodEffects<z.ZodObject<{
+declare const transcriptToolInputSchema: z.ZodObject<{
     checkpointId: z.ZodString;
-    kind: z.ZodOptional<z.ZodEnum<["message", "tool_execution", "legacy_context"]>>;
+    kind: z.ZodOptional<z.ZodEnum<{
+        message: "message";
+        tool_execution: "tool_execution";
+        legacy_context: "legacy_context";
+    }>>;
     afterSequence: z.ZodOptional<z.ZodNumber>;
     sequence: z.ZodOptional<z.ZodNumber>;
     offset: z.ZodOptional<z.ZodNumber>;
     maxChars: z.ZodOptional<z.ZodNumber>;
     limit: z.ZodOptional<z.ZodNumber>;
-}, "strict", z.ZodTypeAny, {
-    checkpointId: string;
-    kind?: "message" | "tool_execution" | "legacy_context" | undefined;
-    limit?: number | undefined;
-    offset?: number | undefined;
-    sequence?: number | undefined;
-    maxChars?: number | undefined;
-    afterSequence?: number | undefined;
-}, {
-    checkpointId: string;
-    kind?: "message" | "tool_execution" | "legacy_context" | undefined;
-    limit?: number | undefined;
-    offset?: number | undefined;
-    sequence?: number | undefined;
-    maxChars?: number | undefined;
-    afterSequence?: number | undefined;
-}>, {
-    checkpointId: string;
-    kind?: "message" | "tool_execution" | "legacy_context" | undefined;
-    limit?: number | undefined;
-    offset?: number | undefined;
-    sequence?: number | undefined;
-    maxChars?: number | undefined;
-    afterSequence?: number | undefined;
-}, {
-    checkpointId: string;
-    kind?: "message" | "tool_execution" | "legacy_context" | undefined;
-    limit?: number | undefined;
-    offset?: number | undefined;
-    sequence?: number | undefined;
-    maxChars?: number | undefined;
-    afterSequence?: number | undefined;
-}>;
+}, z.core.$strict>;
 export type TranscriptToolInput = z.infer<typeof transcriptToolInputSchema>;
 export type TranscriptReader = (options: ReadCheckpointTranscriptOptions) => CheckpointTranscriptPage;
 export declare function executeTranscriptTool(reader: TranscriptReader, input: TranscriptToolInput): NormalizedToolResult;

package/dist/tool-bridge/user-input-tool.js

@@ -1 +1 @@
-import{tool as t}from"ai";import{userInputFormSchema as o}from"@roll-agent/protocol";import{successfulToolResult as e,toolResultToModelOutput as s}from"./normalize-result.js";import{TOOL_RESOURCE_ACCESS_MODES as r,executeCoordinatedTool as i}from"./tool-execution-coordinator.js";export const USER_INPUT_TOOL_AGENT_NAME="roll";export const USER_INPUT_TOOL_NAME="user_input";function n(t){const o="submitted"===t.status?{status:t.status,submittedControlIds:t.values.map(t=>t.id)}:{status:t.status};return e(o,{raw:t,model:{type:"json",value:t}})}function a(){return n({status:"cancelled",reason:"当前客户端不再支持用户输入请求"})}export function buildUserInputTool(e,u,l){const p=u.register("roll","user_input",{annotations:{readOnlyHint:!0}}),c={prepare:()=>e.isAvailable()?void 0:a(),resources:()=>[{key:`session:${e.sessionId}:user-input`,mode:r.write}],revalidateExecution:()=>e.isAvailable()?void 0:a()};return l.register(p,c),{id:p,tools:{[p]:t({description:"向用户展示一个结构化表单，仅用于补充完成当前任务所必需且无法从上下文推断的信息。不得请求密码、令牌、密钥或其他敏感凭证。",inputSchema:o,toModelOutput:({output:t})=>s(t),execute:async(t,o)=>i(l,c,p,o.toolCallId,t,o.abortSignal,async()=>e.isAvailable()?n(await e.request(t,o.abortSignal)):a())})}}}
+import{tool as t}from"ai";import{userInputFormSchema as o}from"@roll-agent/protocol";import{modelToolInputSchema as e}from"./model-input-schema.js";import{successfulToolResult as s,toolResultToModelOutput as r}from"./normalize-result.js";import{TOOL_RESOURCE_ACCESS_MODES as i,executeCoordinatedTool as n}from"./tool-execution-coordinator.js";export const USER_INPUT_TOOL_AGENT_NAME="roll";export const USER_INPUT_TOOL_NAME="user_input";function a(t){const o="submitted"===t.status?{status:t.status,submittedControlIds:t.values.map(t=>t.id)}:{status:t.status};return s(o,{raw:t,model:{type:"json",value:t}})}function u(){return a({status:"cancelled",reason:"当前客户端不再支持用户输入请求"})}export function buildUserInputTool(s,l,p){const c=l.register("roll","user_input",{annotations:{readOnlyHint:!0}}),d={prepare:()=>s.isAvailable()?void 0:u(),resources:()=>[{key:`session:${s.sessionId}:user-input`,mode:i.write}],revalidateExecution:()=>s.isAvailable()?void 0:u()};return p.register(c,d),{id:c,tools:{[c]:t({description:"向用户展示一个结构化表单，仅用于补充完成当前任务所必需且无法从上下文推断的信息。不得请求密码、令牌、密钥或其他敏感凭证。",inputSchema:e(o),toModelOutput:({output:t})=>r(t),execute:async(t,o)=>n(p,d,c,o.toolCallId,t,o.abortSignal,async()=>s.isAvailable()?a(await s.request(t,o.abortSignal)):u())})}}}

package/dist/tool-contracts/agent-types.d.ts

@@ -0,0 +1,32 @@
+import type { AppOutputContract } from "@roll-agent/protocol/app-output";
+import type { JsonSchemaRefIssue } from "./json-schema-refs.ts";
+/** Agent 来源类型 */
+export declare const AGENT_SOURCE_TYPES: readonly ["git", "local-path", "installed-package", "remote-manifest"];
+export type AgentSourceType = (typeof AGENT_SOURCE_TYPES)[number];
+/** Agent 运行时 ownership */
+export declare const AGENT_RUNTIME_OWNERSHIPS: readonly ["on-demand", "core-managed", "external-managed"];
+export type AgentRuntimeOwnership = (typeof AGENT_RUNTIME_OWNERSHIPS)[number];
+/** JSON Schema 子集，对应 MCP tool 的 inputSchema */
+export interface JsonSchemaObject {
+    readonly type: "object";
+    readonly properties?: Readonly<Record<string, object>> | undefined;
+    readonly required?: readonly string[] | undefined;
+    readonly additionalProperties?: boolean | undefined;
+    readonly [key: string]: unknown;
+}
+/** MCP Tool Schema */
+export interface AgentTool {
+    readonly name: string;
+    readonly description?: string | undefined;
+    readonly inputSchema: JsonSchemaObject;
+    readonly schemaIssues?: readonly JsonSchemaRefIssue[];
+    readonly appOutput?: AppOutputContract;
+    readonly appOutputIssue?: "invalid_contract";
+    /** Validated MCP request deadline advertised by this tool. */
+    readonly executionTimeoutMs?: number;
+}
+export declare const AGENT_TRANSPORT_KINDS: {
+    readonly stdio: "stdio";
+    readonly streamableHttp: "streamable-http";
+};
+export type AgentTransportKind = (typeof AGENT_TRANSPORT_KINDS)[keyof typeof AGENT_TRANSPORT_KINDS];

package/dist/tool-contracts/agent-types.js

@@ -0,0 +1 @@
+export const AGENT_SOURCE_TYPES=["git","local-path","installed-package","remote-manifest"];export const AGENT_RUNTIME_OWNERSHIPS=["on-demand","core-managed","external-managed"];export const AGENT_TRANSPORT_KINDS={stdio:"stdio",streamableHttp:"streamable-http"};

package/dist/tool-contracts/execution-timeout.d.ts

@@ -0,0 +1,2 @@
+export declare const ROLL_EXECUTION_TIMEOUT_META_KEY = "roll/executionTimeoutMs";
+export declare function readExecutionTimeoutMs(metadata: unknown): number | undefined;

package/dist/tool-contracts/execution-timeout.js

@@ -0,0 +1 @@
+export const ROLL_EXECUTION_TIMEOUT_META_KEY="roll/executionTimeoutMs";export function readExecutionTimeoutMs(e){const o="object"!=typeof e||null===e||Array.isArray(e)?void 0:Reflect.get(e,"roll/executionTimeoutMs");return"number"==typeof o&&Number.isSafeInteger(o)&&o>=1e3&&o<=18e5?o:void 0}

package/dist/tool-contracts/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./agent-types.ts";
+export * from "./issues.ts";
+export * from "./json-schema-refs.ts";
+export * from "./schema.ts";
+export * from "./preflight.ts";
+export * from "./execution-timeout.ts";
+export * from "./results.ts";
+export * from "./resource-hints.ts";

package/dist/tool-contracts/index.js

@@ -0,0 +1 @@
+export*from"./agent-types.js";export*from"./issues.js";export*from"./json-schema-refs.js";export*from"./schema.js";export*from"./preflight.js";export*from"./execution-timeout.js";export*from"./results.js";export*from"./resource-hints.js";

package/dist/tool-contracts/issues.d.ts

@@ -0,0 +1,22 @@
+export declare const ASK_VALIDATION_ISSUE_CODES: readonly ["missing_required", "requires_explicit_input", "invalid_type", "invalid_enum", "too_small", "unexpected_property"];
+export type AskValidationIssueCode = (typeof ASK_VALIDATION_ISSUE_CODES)[number];
+export declare const ASK_RUNTIME_ISSUE_CATEGORIES: readonly ["env"];
+export type AskRuntimeIssueCategory = (typeof ASK_RUNTIME_ISSUE_CATEGORIES)[number];
+export declare const ASK_RUNTIME_ISSUE_CODES: readonly ["missing_required_env"];
+export type AskRuntimeIssueCode = (typeof ASK_RUNTIME_ISSUE_CODES)[number];
+export interface AskValidationIssue {
+    readonly path: string;
+    readonly code: AskValidationIssueCode;
+    readonly message: string;
+    readonly description?: string;
+    readonly expected?: string;
+    readonly actual?: string;
+}
+export interface AskRuntimeIssue {
+    readonly category: AskRuntimeIssueCategory;
+    readonly code: AskRuntimeIssueCode;
+    readonly name: string;
+    readonly message: string;
+    readonly purpose?: string;
+    readonly example?: string;
+}

package/dist/tool-contracts/issues.js

@@ -0,0 +1 @@
+export const ASK_VALIDATION_ISSUE_CODES=["missing_required","requires_explicit_input","invalid_type","invalid_enum","too_small","unexpected_property"];export const ASK_RUNTIME_ISSUE_CATEGORIES=["env"];export const ASK_RUNTIME_ISSUE_CODES=["missing_required_env"];

package/dist/tool-contracts/json-schema-refs.d.ts

@@ -0,0 +1,19 @@
+export declare const JSON_SCHEMA_REF_ISSUE_REASONS: {
+    readonly recursive: "recursive";
+    readonly external: "external";
+    readonly unresolvable: "unresolvable";
+    readonly siblingKeywords: "sibling-keywords";
+    readonly limit: "limit";
+};
+export type JsonSchemaRefIssueReason = (typeof JSON_SCHEMA_REF_ISSUE_REASONS)[keyof typeof JSON_SCHEMA_REF_ISSUE_REASONS];
+export interface JsonSchemaRefIssue {
+    readonly path: string;
+    readonly ref: string;
+    readonly reason: JsonSchemaRefIssueReason;
+}
+export interface InlineJsonSchemaRefsResult<T> {
+    readonly schema: T;
+    readonly unresolved: readonly JsonSchemaRefIssue[];
+}
+export declare function isRootDefinitionReference(ref: string): boolean;
+export declare function inlineAcyclicLocalJsonSchemaReferences<T extends object>(schema: T): InlineJsonSchemaRefsResult<T>;

package/dist/tool-contracts/json-schema-refs.js

@@ -0,0 +1 @@
+export const JSON_SCHEMA_REF_ISSUE_REASONS={recursive:"recursive",external:"external",unresolvable:"unresolvable",siblingKeywords:"sibling-keywords",limit:"limit"};const e=32,t=1e4,n=262144,r=new Set(["description","title","default","examples","deprecated","readOnly","writeOnly","$comment"]),i=new Set(["$defs","definitions"]),s=["#/$defs/","#/definitions/"],o=new Set(["additionalItems","additionalProperties","allOf","anyOf","contains","contentSchema","else","if","items","not","oneOf","prefixItems","propertyNames","then","unevaluatedItems","unevaluatedProperties"]),u=new Set(["dependencies","dependentSchemas","patternProperties","properties"]),c=/^(?:0|[1-9]\d*)$/u;class InlineLimitExceeded extends Error{}function a(e){return"object"==typeof e&&null!==e&&!Array.isArray(e)}function d(e){return"boolean"==typeof e||a(e)}export function isRootDefinitionReference(e){const t=s.find(t=>e.startsWith(t)),n=void 0===t?void 0:e.slice(t.length);if(void 0===n||0===n.length||n.includes("/"))return!1;let r;try{r=decodeURIComponent(n)}catch{return!1}return!r.includes("/")&&!/~(?![01])/u.test(r)}function l(e){if(!/~(?![01])/u.test(e))return e.replace(/~1/gu,"/").replace(/~0/gu,"~")}function f(e){return e.replace(/~/gu,"~0").replace(/\//gu,"~1")}function S(e,t){let n;try{n=decodeURIComponent(t.slice(1))}catch{return}if(0===n.length)return e;if(!n.startsWith("/"))return;let r=e;for(const e of n.slice(1).split("/")){const t=l(e);if(void 0===t)return;if(Array.isArray(r))r=c.test(t)?r[Number(t)]:void 0;else{if(!a(r))return;r=Object.prototype.hasOwnProperty.call(r,t)?r[t]:void 0}if(void 0===r)return}return r}function p(e,t,n){return e.startsWith("#")?t.activeRefs.includes(e)?JSON_SCHEMA_REF_ISSUE_REASONS.recursive:d(S(n,e))?void 0:JSON_SCHEMA_REF_ISSUE_REASONS.unresolvable:JSON_SCHEMA_REF_ISSUE_REASONS.external}function h(e,t){return!0===e?{...t}:!1===e?{not:{},...t}:{...e,...t}}function E(e,t,n,r){return Object.fromEntries(Object.entries(e).map(([e,i])=>{const s=`${t}/${f(e)}`;return o.has(e)?[e,v(i,s,n,r)]:u.has(e)&&a(i)?[e,Object.fromEntries(Object.entries(i).map(([e,t])=>[e,v(t,`${s}/${f(e)}`,n,r)]))]:[e,i]}))}function v(n,s,o,u){if(o.activeRefs.length>0&&(u.expandedNodes+=1,u.expandedNodes>t||o.expansionDepth>e))throw new InlineLimitExceeded;if(Array.isArray(n))return n.map((e,t)=>v(e,`${s}/${String(t)}`,o,u));if(!a(n))return n;const{$ref:c,...l}=n;if("string"!=typeof c)return E(n,s,o,u);if(Object.keys(l).some(e=>!r.has(e)&&!i.has(e)))return u.unresolved.push({path:s,ref:c,reason:JSON_SCHEMA_REF_ISSUE_REASONS.siblingKeywords}),n;const f=p(c,o,u.root);if(void 0!==f)return u.unresolved.push({path:s,ref:c,reason:f}),n;const _={root:u.root,unresolved:[],expandedNodes:u.expandedNodes},m=v(S(u.root,c),s,{activeRefs:[...o.activeRefs,c],expansionDepth:o.expansionDepth+1},_);u.expandedNodes=_.expandedNodes;return _.unresolved.some(e=>e.reason===JSON_SCHEMA_REF_ISSUE_REASONS.recursive&&e.ref===c)?(u.unresolved.push({path:s,ref:c,reason:JSON_SCHEMA_REF_ISSUE_REASONS.recursive}),n):(u.unresolved.push(..._.unresolved),d(m)?h(m,l):n)}function _(e){return Buffer.byteLength(JSON.stringify(e),"utf8")}export function inlineAcyclicLocalJsonSchemaReferences(e){const t=JSON.stringify(e);if(!t.includes('"$ref"'))return{schema:e,unresolved:[]};const r={root:e,unresolved:[],expandedNodes:0};try{const i=v(e,"",{activeRefs:[],expansionDepth:0},r),s=_(i);if(s>n&&s>Buffer.byteLength(t,"utf8"))throw new InlineLimitExceeded;return{schema:i,unresolved:r.unresolved}}catch(t){if(t instanceof InlineLimitExceeded)return{schema:e,unresolved:[{path:"",ref:"#",reason:JSON_SCHEMA_REF_ISSUE_REASONS.limit}]};throw t}}

package/dist/tool-contracts/preflight.d.ts

@@ -0,0 +1,16 @@
+import type { AgentTool } from "./agent-types.ts";
+import type { AskRuntimeIssue, AskValidationIssue } from "./issues.ts";
+export interface ToolCallPreflightSuccess {
+    readonly ok: true;
+}
+export interface ToolCallPreflightFailure {
+    readonly ok: false;
+    readonly issues: ReadonlyArray<AskValidationIssue>;
+    readonly runtimeIssues: ReadonlyArray<AskRuntimeIssue>;
+}
+export type ToolCallPreflightResult = ToolCallPreflightSuccess | ToolCallPreflightFailure;
+export interface ToolCallPreflightOptions {
+    readonly runtimeIssues?: ReadonlyArray<AskRuntimeIssue>;
+}
+export declare function getInputValidationIssues(tool: Pick<AgentTool, "inputSchema">, input: Readonly<Record<string, unknown>>): ReadonlyArray<AskValidationIssue>;
+export declare function preflightToolCall(tool: Pick<AgentTool, "inputSchema">, input: Readonly<Record<string, unknown>>, options?: ToolCallPreflightOptions): ToolCallPreflightResult;

package/dist/tool-contracts/preflight.js

@@ -0,0 +1 @@
+import{describeValueType as e,getAdditionalPropertiesSetting as t,getSchemaDescription as n,getSchemaEnum as r,getSchemaItems as s,getSchemaMinItems as i,getSchemaProperties as u,getSchemaRequired as o,getSchemaType as c,isNaturallyExtractableSchema as a,isJsonSchemaObject as p,isPlainObject as l}from"./schema.js";function g(e,t){const r=n(t),s=t&&!a(t);return{path:e,code:s?"requires_explicit_input":"missing_required",message:s?`${e} 无法从自然语言可靠提取，需要显式提供`:`${e} 为必填字段`,...r?{description:r}:{}}}function f(e,t){if(t&&p(t)){const n=h({inputSchema:t},{},e);if(n.length>0)return n}return[g(e,t)]}function m(t,u,o){const a=[],g=n(t),f=r(t),d=c(t);if(f&&!f.some(e=>Object.is(e,u)))return a.push({path:o,code:"invalid_enum",message:`${o} 必须是以下值之一：${f.map(e=>JSON.stringify(e)).join("、")}`,...g?{description:g}:{},expected:f.map(e=>JSON.stringify(e)).join(" | "),actual:JSON.stringify(u)}),a;if(!d)return a;const $=e(u),y=()=>{a.push({path:o,code:"invalid_type",message:`${o} 应为 ${d}，当前是 ${$}`,...g?{description:g}:{},expected:d,actual:$})};switch(d){case"string":return"string"!=typeof u&&y(),a;case"number":return("number"!=typeof u||Number.isNaN(u))&&y(),a;case"integer":return"number"==typeof u&&Number.isInteger(u)||y(),a;case"boolean":return"boolean"!=typeof u&&y(),a;case"null":return null!==u&&y(),a;case"array":if(!Array.isArray(u))return y(),a;{const e=i(t);void 0!==e&&u.length<e&&a.push({path:o,code:"too_small",message:`${o} 至少需要 ${String(e)} 个元素，当前是 ${String(u.length)} 个`,...g?{description:g}:{},expected:`minItems: ${String(e)}`,actual:`length: ${String(u.length)}`});const n=s(t);return n?(a.push(...u.flatMap((e,t)=>m(n,e,`${o}[${String(t)}]`))),a):a}case"object":return l(u)?p(t)?h({inputSchema:t},u,o):a:(y(),a);default:return a}}function h(e,n,r=""){const s=o(e),i=u(e.inputSchema),c=[];for(const e of s){const t=n[e];if(null!=t)continue;const s=i[e],u=r?`${r}.${e}`:e;c.push(...f(u,s))}for(const[s,u]of Object.entries(n)){const n=r?`${r}.${s}`:s,o=i[s];o?c.push(...m(o,u,n)):!1===t(e.inputSchema)&&c.push({path:n,code:"unexpected_property",message:`${n} 不是允许的参数`})}return c}export function getInputValidationIssues(e,t){return h(e,t)}export function preflightToolCall(e,t,n={}){const r=getInputValidationIssues(e,t),s=n.runtimeIssues??[];return 0===r.length&&0===s.length?{ok:!0}:{ok:!1,issues:r,runtimeIssues:s}}

package/dist/tool-contracts/resource-hints.d.ts

@@ -0,0 +1,26 @@
+export declare const ROLL_RESOURCE_HINTS_META_KEY = "roll/resourceHints";
+export declare const TOOL_RESOURCE_ACCESS_MODES: {
+    readonly read: "read";
+    readonly write: "write";
+};
+export declare const OPAQUE_SIDE_EFFECT_RESOURCE = "shell:opaque-side-effects";
+export type ToolResourceAccessMode = (typeof TOOL_RESOURCE_ACCESS_MODES)[keyof typeof TOOL_RESOURCE_ACCESS_MODES];
+export interface ToolResourceAccess {
+    readonly key: string;
+    readonly mode: ToolResourceAccessMode;
+}
+export declare const TOOL_RESOURCE_HINT_KINDS: {
+    readonly file: "file";
+    readonly browserSession: "browser-session";
+    readonly conversation: "conversation";
+    readonly custom: "custom";
+};
+export type ToolResourceHintKind = (typeof TOOL_RESOURCE_HINT_KINDS)[keyof typeof TOOL_RESOURCE_HINT_KINDS];
+export interface ToolResourceHint {
+    /** Top-level tool input field containing one resource id or an array of ids. */
+    readonly field: string;
+    readonly kind: ToolResourceHintKind;
+    readonly mode?: ToolResourceAccessMode;
+    /** Required for `custom`; ignored for built-in kinds. */
+    readonly namespace?: string;
+}

package/dist/tool-contracts/resource-hints.js

@@ -0,0 +1 @@
+export const ROLL_RESOURCE_HINTS_META_KEY="roll/resourceHints";export const TOOL_RESOURCE_ACCESS_MODES={read:"read",write:"write"};export const OPAQUE_SIDE_EFFECT_RESOURCE="shell:opaque-side-effects";export const TOOL_RESOURCE_HINT_KINDS={file:"file",browserSession:"browser-session",conversation:"conversation",custom:"custom"};

package/dist/tool-contracts/results.d.ts

@@ -0,0 +1,7 @@
+import { type AppOutputContract } from "@roll-agent/protocol/app-output";
+export { getCompletedAppOutputStatus } from "@roll-agent/protocol/app-output";
+export declare function extractTextContent(content: unknown): string[];
+export declare function isToolErrorResult(result: unknown, appOutput?: AppOutputContract): result is {
+    readonly isError: true;
+    readonly content?: unknown;
+};

package/dist/tool-contracts/results.js

@@ -0,0 +1 @@
+import{getCompletedAppOutputStatus as t}from"@roll-agent/protocol/app-output";export{getCompletedAppOutputStatus}from"@roll-agent/protocol/app-output";export function extractTextContent(t){if(!Array.isArray(t))return[];const o=[];for(const r of t)"object"==typeof r&&null!==r&&"type"in r&&"text"===r.type&&"text"in r&&"string"==typeof r.text&&o.push(r.text);return o}export function isToolErrorResult(o,r){return(void 0===r||void 0===t(o))&&("object"==typeof o&&null!==o&&"isError"in o&&!0===o.isError)}

package/dist/tool-contracts/schema.d.ts

@@ -0,0 +1,13 @@
+import type { AgentTool } from "./agent-types.ts";
+export declare function isPlainObject(value: unknown): value is Readonly<Record<string, unknown>>;
+export declare function isJsonSchemaObject(value: object): value is AgentTool["inputSchema"];
+export declare function getSchemaDescription(schema: object | undefined): string | undefined;
+export declare function getSchemaType(schema: object | undefined): string | undefined;
+export declare function getSchemaEnum(schema: object | undefined): ReadonlyArray<unknown> | undefined;
+export declare function getSchemaItems(schema: object | undefined): object | undefined;
+export declare function getSchemaMinItems(schema: object | undefined): number | undefined;
+export declare function getSchemaProperties(schema: Pick<AgentTool, "inputSchema">["inputSchema"] | object | undefined): Readonly<Record<string, object>>;
+export declare function isNaturallyExtractableSchema(schema: object | undefined): boolean;
+export declare function getSchemaRequired(tool: Pick<AgentTool, "inputSchema">): ReadonlyArray<string>;
+export declare function getAdditionalPropertiesSetting(schema: Pick<AgentTool, "inputSchema">["inputSchema"] | object | undefined): boolean | undefined;
+export declare function describeValueType(value: unknown): string;

package/dist/tool-contracts/schema.js

@@ -0,0 +1 @@
+export function isPlainObject(e){return"object"==typeof e&&null!==e&&!Array.isArray(e)}export function isJsonSchemaObject(e){return"type"in e&&"object"===e.type}export function getSchemaDescription(e){return e&&"description"in e&&"string"==typeof e.description?e.description:void 0}export function getSchemaType(e){return e&&"type"in e&&"string"==typeof e.type?e.type:void 0}export function getSchemaEnum(e){return e&&"enum"in e&&Array.isArray(e.enum)?e.enum:void 0}export function getSchemaItems(e){return e&&"items"in e&&"object"==typeof e.items&&null!==e.items?e.items:void 0}export function getSchemaMinItems(e){return e&&"minItems"in e&&"number"==typeof e.minItems?e.minItems:void 0}export function getSchemaProperties(e){if(!(e&&"properties"in e&&e.properties&&isPlainObject(e.properties)))return{};const t=Object.entries(e.properties).filter(e=>{const[,t]=e;return"object"==typeof t&&null!==t});return Object.fromEntries(t)}export function isNaturallyExtractableSchema(e){return!!e&&("object"!==getSchemaType(e)||Object.keys(getSchemaProperties(e)).length>0)}export function getSchemaRequired(e){return e.inputSchema.required??[]}export function getAdditionalPropertiesSetting(e){return e&&"additionalProperties"in e&&"boolean"==typeof e.additionalProperties?e.additionalProperties:void 0}export function describeValueType(e){return null===e?"null":Array.isArray(e)?"array":typeof e}

package/dist/types/cancellation.d.ts

@@ -9,16 +9,12 @@ export type SessionCancellationReason = (typeof SESSION_CANCELLATION_REASONS)[ke
 export declare const turnCancellationMetadataV1Schema: z.ZodReadonly<z.ZodObject<{
     version: z.ZodLiteral<1>;
     kind: z.ZodLiteral<"turn-cancellation">;
-    reason: z.ZodEnum<["user", "timeout", "runtime"]>;
-}, "strip", z.ZodTypeAny, {
-    kind: "turn-cancellation";
-    version: 1;
-    reason: "runtime" | "user" | "timeout";
-}, {
-    kind: "turn-cancellation";
-    version: 1;
-    reason: "runtime" | "user" | "timeout";
-}>>;
+    reason: z.ZodEnum<{
+        user: "user";
+        timeout: "timeout";
+        runtime: "runtime";
+    }>;
+}, z.core.$strip>>;
 export declare function createTurnCancellationMessage(content: string, reason: SessionCancellationReason): AssistantModelMessage;
 export declare function readTurnCancellationReason(message: ModelMessage): SessionCancellationReason | undefined;
 export declare function stripTurnCancellationMetadata(messages: readonly ModelMessage[]): ModelMessage[];

package/dist/types/events.d.ts

@@ -13,6 +13,16 @@ export interface SessionTokenUsage {
 export type SessionEventStage = "bootstrap" | "plan" | "execute";
 export type SessionDebugStage = "turn" | "compaction" | "model" | "persist";
 export type SessionDebugData = Readonly<Record<string, string | number | boolean>>;
+export declare const COMPACTION_FAILURE_REASONS: {
+    readonly timeout: "timeout";
+    readonly error: "error";
+};
+export type ContextCompactionFailure = {
+    readonly reason: typeof COMPACTION_FAILURE_REASONS.timeout;
+    readonly timeoutMs: number;
+} | {
+    readonly reason: typeof COMPACTION_FAILURE_REASONS.error;
+};
 export type SessionEvent = {
     readonly type: "context-recovery";
     readonly state: ContextRecoveryView | null;
@@ -129,6 +139,8 @@ export type SessionEvent = {
     readonly truncatedTools?: number;
     readonly beforeInputTokens?: number;
     readonly recoveryNotice?: string;
+    /** Diagnostic only: a failed attempt leaves the original context intact. */
+    readonly failure?: ContextCompactionFailure;
     readonly checkpointId?: string;
     readonly checkpointGeneration?: number;
     readonly checkpointSummaryStatus?: "valid" | "fallback" | "skipped";

package/dist/types/events.js

@@ -1 +1 @@
-export{};
+export const COMPACTION_FAILURE_REASONS={timeout:"timeout",error:"error"};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roll-agent/runtime",
-  "version": "0.27.0",
+  "version": "1.0.1",
   "type": "module",
   "repository": {
     "type": "git",
@@ -14,6 +14,18 @@
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./skills": {
+      "types": "./dist/skills/index.d.ts",
+      "default": "./dist/skills/index.js"
+    },
+    "./tool-contracts": {
+      "types": "./dist/tool-contracts/index.d.ts",
+      "default": "./dist/tool-contracts/index.js"
+    },
+    "./host-contracts": {
+      "types": "./dist/host-contracts/index.d.ts",
+      "default": "./dist/host-contracts/index.js"
     }
   },
   "publishConfig": {
@@ -26,17 +38,16 @@
     "node": ">=22.6.0"
   },
   "dependencies": {
-    "@ai-sdk/provider": "^4.0.7",
+    "@ai-sdk/provider": "4.0.31",
     "@modelcontextprotocol/sdk": "1.32.0",
-    "@roll-agent/protocol": "0.9.0",
+    "@roll-agent/protocol": "0.10.0",
     "@vscode/ripgrep": "1.18.0",
-    "ai": "^7.0.65",
+    "ai": "7.0.146",
     "diff": "9.0.0",
     "yaml": "2.8.3",
-    "zod": "^3.25.76"
+    "zod": "4.6.6"
   },
   "devDependencies": {
-    "@roll-agent/core": "0.44.0",
     "@types/node": "^22.0.0"
   },
   "scripts": {