@roll-agent/runtime 0.27.0 → 1.0.0

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roll-agent/runtime",
-  "version": "0.27.0",
+  "version": "1.0.0",
   "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": {