@caplets/core 0.18.9 → 0.20.0

package/dist/code-mode/runtime-api.generated.d.ts

@@ -0,0 +1 @@
+export declare const CODE_MODE_RUNTIME_API_DECLARATION: "type JsonPrimitive=string|number|boolean|null;type JsonValue=JsonPrimitive|JsonValue[]|{[key:string]:JsonValue};interface CapletHandle<Id extends string>{readonly id:Id;/** Show this Caplet card,without tool/resource/prompt schemas. */ inspect():Promise<CapletCard<Id>>;/** Check backend readiness/auth;expected unavailable states return ok:false. */ check():Promise<CapletsResult<BackendCheckResult>>;/** List tool summaries for the discovery pass;may be empty. */ tools(input?:PageInput):Promise<Page<ToolSummary>>;/** Search tool summaries for the discovery pass;may be empty. */ searchTools(query:string,input?:PageInput):Promise<Page<ToolSummary>>;/** Get schema,callSignature,types,examples;prefer outputSchema/outputTypeScript over observed hints. */ describeTool(name:string):Promise<CapletsResult<ToolDescriptor>>;/** Call one tool;expected failures return ok:false. Filter bulky data in script before returning. */ callTool(name:string,args?:unknown):Promise<CapletsResult<unknown>>;/** List readable resources for the discovery pass;many backends expose none. */ resources(input?:PageInput):Promise<Page<ResourceSummary>>;/** Search readable resources for the discovery pass;many backends expose none. */ searchResources(query:string,input?:PageInput):Promise<Page<ResourceSummary>>;/** List resource templates for the discovery pass;many backends expose none. */ resourceTemplates(input?:PageInput):Promise<Page<ResourceTemplateSummary>>;/** Read one resource by URI;unsupported/missing resources return ok:false. */ readResource(uri:string):Promise<CapletsResult<ResourceReadResult>>;/** List reusable prompts for the discovery pass;many backends expose none. */ prompts(input?:PageInput):Promise<Page<PromptSummary>>;/** Search reusable prompts for the discovery pass;many backends expose none. */ searchPrompts(query:string,input?:PageInput):Promise<Page<PromptSummary>>;/** Get one prompt by name and args;unsupported/missing prompts return ok:false. */ getPrompt(name:string,args?:unknown):Promise<CapletsResult<PromptResult>>;/** Complete a prompt or resource-template argument. */ complete(input:CompleteInput):Promise<CapletsResult<CompleteResult>>;}interface DebugApi{readLogs(input:ReadLogsInput):Promise<ReadLogsResult>;}type CapletCard<Id extends string>={id:Id;name:string;description:string;useWhen?:string;avoidWhen?:string;tags?:string[];backend?:unknown;};type PageInput={limit?:number;cursor?:string};type Page<T>={items:T[];nextCursor?:string;truncated?:boolean};type CapletsResult<T>=|{ok:true;data:T;meta?:CapletsMeta}|{ok:false;error:CapletsError;meta?:CapletsMeta};type CapletsMeta={[key:string]:unknown};type CapletsError={code:string;message:string;details?:unknown};type BackendCheckResult=unknown;type ToolSummary={/** Exact downstream tool identifier for describeTool(name)and callTool(name,args). */ name:string;title?:string;description?:string;/** Optional author-supplied hint for when to prefer this tool. */ useWhen?:string;/** Optional author-supplied hint for when to avoid this tool. */ avoidWhen?:string;/** True when the tool declares that it only reads data. */ readOnlyHint?:boolean;/** True when the tool declares that it may perform destructive writes. */ destructiveHint?:boolean;};type ToolDescriptor={id?:string;tool?:unknown;inputSchema?:unknown;outputSchema?:unknown;callSignature?:string;inputTypeScript?:string;outputTypeScript?:string;observedOutputShape?:ObservedOutputShape;examples?:unknown[];};type ObservedOutputShape={version:1;source:\"observed\";observedAt:string;sampleCount:number;typeScript:string;jsonShape:JsonShape;truncated:boolean;};type JsonShape=|{kind:\"null\"}|{kind:\"boolean\"}|{kind:\"number\"}|{kind:\"string\"}|{kind:\"unknown\"}|{kind:\"array\";element?:JsonShape;truncated?:boolean}|{kind:\"object\";fields:Record<string,{optional:boolean;shape:JsonShape}>;truncated?:boolean;}|{kind:\"union\";variants:JsonShape[]};type ResourceSummary={uri?:string;name?:string;title?:string;description?:string};type ResourceTemplateSummary={uriTemplate?:string;name?:string;title?:string;description?:string;};type ResourceReadResult=unknown;type PromptSummary={name?:string;title?:string;description?:string};type PromptResult=unknown;type CompleteInput={ref:{type:\"prompt\";name:string}|{type:\"resourceTemplate\";uri:string};argument:{name:string;value:string};};type CompleteResult=unknown;type ReadLogsInput={logRef:string;cursor?:string;limit?:number};type ReadLogsResult={entries:CodeModeLogEntry[];nextCursor?:string};type CodeModeLogEntry={level:\"log\"|\"info\"|\"warn\"|\"error\"|\"debug\";message:string;timestamp:string;};interface Console{log(...values:unknown[]):void;info(...values:unknown[]):void;warn(...values:unknown[]):void;error(...values:unknown[]):void;debug(...values:unknown[]):void;}declare const console:Console;";

package/dist/code-mode/sandbox.d.ts

@@ -0,0 +1,28 @@
+import type { CodeModeLogEntry } from "./types";
+export type CodeModeSandboxInvokeInput = {
+    capletId: string;
+    method: "inspect" | "check" | "tools" | "searchTools" | "describeTool" | "callTool" | "resources" | "searchResources" | "resourceTemplates" | "readResource" | "prompts" | "searchPrompts" | "getPrompt" | "complete" | "readLogs";
+    args: unknown[];
+};
+export type CodeModeSandboxInput = {
+    code: string;
+    capletIds: string[];
+    timeoutMs: number;
+    invoke: (input: CodeModeSandboxInvokeInput) => Promise<unknown>;
+};
+export type CodeModeSandboxResult = {
+    ok: true;
+    value: unknown;
+    logs: CodeModeLogEntry[];
+} | {
+    ok: false;
+    error: string;
+    logs: CodeModeLogEntry[];
+    stack?: string;
+};
+export interface CodeModeSandbox {
+    run(input: CodeModeSandboxInput): Promise<CodeModeSandboxResult>;
+}
+export declare class QuickJsCodeModeSandbox implements CodeModeSandbox {
+    run(input: CodeModeSandboxInput): Promise<CodeModeSandboxResult>;
+}

package/dist/code-mode/static-analysis.d.ts

@@ -0,0 +1,2 @@
+export declare function hasDirectFetchCall(code: string): boolean;
+export declare function hasExecutableImport(code: string): boolean;

package/dist/code-mode/tool.d.ts

@@ -0,0 +1,11 @@
+import { z } from "zod";
+export declare const codeModeRunInputSchema: z.ZodObject<{
+    code: z.ZodString;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const codeModeRunParamsSchema: {
+    code: z.ZodString;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+};
+export declare function codeModeRunInputJsonSchema(): Record<string, unknown>;
+export declare function isCodeModeRunRequest(value: unknown): boolean;

package/dist/code-mode/types.d.ts

@@ -0,0 +1,120 @@
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type CodeModeCallableCaplet = {
+    id: string;
+    name: string;
+    description: string;
+    useWhen?: string;
+    avoidWhen?: string;
+};
+export type CodeModeDeclarationInput = {
+    caplets: CodeModeCallableCaplet[];
+};
+export type CodeModeTypesJson = {
+    declaration: string;
+    declarationHash: string;
+    callableCount: number;
+    generatedAt: string;
+    runtimeScope: string;
+};
+export type CodeModeDiagnostic = {
+    code: string;
+    message: string;
+    severity: "error" | "warning" | "info";
+    line?: number;
+    column?: number;
+};
+export type CodeModeRunMeta = {
+    runId: string;
+    traceId: string;
+    declarationHash: string;
+    durationMs: number;
+    timeoutMs: number;
+    maxTimeoutMs: number;
+};
+export type CodeModeRunError = {
+    code: string;
+    message: string;
+    details?: unknown;
+    location?: {
+        line: number;
+        column: number;
+    };
+    hint?: string;
+    stackPreview?: string[];
+};
+export type CodeModeLogEntry = {
+    level: "log" | "info" | "warn" | "error" | "debug";
+    message: string;
+    timestamp: string;
+};
+export type CodeModeLogs = {
+    entries: CodeModeLogEntry[];
+    truncated: boolean;
+    stored: boolean;
+    logRef?: string;
+    nextCursor?: string;
+    expiresAt?: string;
+};
+export type CodeModeRunEnvelope = {
+    ok: true;
+    value: JsonValue;
+    diagnostics: CodeModeDiagnostic[];
+    logs: CodeModeLogs;
+    meta: CodeModeRunMeta;
+} | {
+    ok: false;
+    error: CodeModeRunError;
+    diagnostics: CodeModeDiagnostic[];
+    logs: CodeModeLogs;
+    meta: CodeModeRunMeta;
+};
+export type ToolCallMeta = {
+    capletId?: string;
+    tool?: string;
+    durationMs?: number;
+    [key: string]: unknown;
+};
+export type ToolCallError = {
+    code: string;
+    message: string;
+    details?: unknown;
+};
+export type ToolCallResult = {
+    ok: true;
+    data: unknown;
+    meta?: ToolCallMeta;
+} | {
+    ok: false;
+    error: ToolCallError;
+    meta?: ToolCallMeta;
+};
+export type CapletsResult<T> = {
+    ok: true;
+    data: T;
+    meta?: ToolCallMeta;
+} | {
+    ok: false;
+    error: ToolCallError;
+    meta?: ToolCallMeta;
+};
+export type Page<T> = {
+    items: T[];
+    nextCursor?: string;
+    truncated?: boolean;
+};
+export type PageInput = {
+    limit?: number;
+    cursor?: string;
+};
+export type ReadLogsInput = {
+    logRef: string;
+    cursor?: string;
+    limit?: number;
+};
+export type ReadLogsResult = {
+    entries: CodeModeLogEntry[];
+    nextCursor?: string;
+};