@xiaozhiclaw/qlogicagent-core 0.1.5 → 0.2.0

package/dist/types/runtime/ports/model-transport-contracts.d.ts

@@ -0,0 +1,92 @@
+import type { ChatMessage, ToolDefinition } from "./agent-execution-contracts.js";
+import type { WireUsageRecord } from "../../contracts/usage.js";
+import type { ModelOperation, ModelRecoveryProof } from "../../embedded/model-operation.js";
+export interface LLMRequest {
+    /** Stable product execution reference; not a provider-side idempotency guarantee. */
+    execution?: {
+        requestId: string;
+        requestDigest: string;
+        round: number;
+        attempt: number;
+    };
+    model: string;
+    messages: ChatMessage[];
+    tools?: ToolDefinition[];
+    toolChoice?: "auto" | "none" | "required" | {
+        type: "function";
+        name: string;
+    };
+    temperature?: number;
+    maxTokens?: number;
+    reasoning?: {
+        effort: "minimal" | "low" | "medium" | "high" | "xhigh";
+        includeEncryptedReasoning?: boolean;
+    };
+    /** Core-enforced executable function-call budget; not a Chat Completions wire field. */
+    maxToolCalls?: number;
+    streamRequired?: boolean;
+    promptCacheKey?: string;
+    promptCacheRetention?: "in_memory" | "24h";
+    serviceTier?: "auto" | "default" | "flex" | "priority";
+    parallelToolCalls?: boolean;
+    textVerbosity?: "low" | "medium" | "high";
+}
+export type LLMChunk = {
+    type: "delta";
+    text: string;
+} | {
+    type: "tool_call_delta";
+    index: number;
+    id?: string;
+    name?: string;
+    arguments: string;
+    argumentsMode?: "append" | "replace";
+} | {
+    type: "reasoning_delta";
+    text: string;
+} | {
+    type: "reasoning_block_complete";
+    thinking: string;
+    signature: string;
+} | {
+    type: "usage";
+    totalPromptTokens?: number;
+    promptTokens: number;
+    completionTokens: number;
+    reasoningTokens?: number;
+    cacheReadTokens?: number;
+    cacheCreationTokens?: number;
+    records?: WireUsageRecord[];
+} | {
+    type: "response_id";
+    id: string;
+} | {
+    type: "annotations";
+    annotations: Array<{
+        type: string;
+        url?: string;
+        title?: string;
+        [key: string]: unknown;
+    }>;
+} | {
+    type: "error";
+    message: string;
+    outcome?: "rejected" | "unknown";
+} | {
+    type: "done";
+    finishReason: string;
+};
+export interface AccumulatedToolCall {
+    id: string;
+    name: string;
+    arguments: string;
+}
+export interface LLMTransport {
+    /** Forward requested provider controls or reject unsupported ones before inference; never silently discard them. */
+    stream(request: LLMRequest, apiKey: string, signal?: AbortSignal): AsyncGenerator<LLMChunk>;
+    /** Query the original service receipt without starting inference. Missing evidence must reject. */
+    reconcileModel?(operation: ModelOperation, apiKey: string, signal?: AbortSignal): Promise<ModelRecoveryProof>;
+}
+export declare function accumulateToolCalls(accumulator: Map<number, AccumulatedToolCall>, chunk: LLMChunk & {
+    type: "tool_call_delta";
+}): void;

package/dist/types/runtime/ports/tool-call-contracts.d.ts

@@ -0,0 +1,20 @@
+export interface OpenAiToolCall {
+    id: string;
+    type: "function";
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+export interface ToolResultMessageInput {
+    ok: boolean;
+    payload?: unknown;
+    error?: string;
+    toolReferences?: string[];
+    imageUrls?: string[];
+    contentBlocks?: import("../../contracts/tool-result.js").ToolResult["contentBlocks"];
+    structuredContent?: Record<string, unknown>;
+    mcpMeta?: Record<string, unknown>;
+    mcpIsError?: boolean;
+}
+export declare function buildToolResultMessage(callId: string, result: ToolResultMessageInput): import("../../contracts/chat.js").ChatMessage;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xiaozhiclaw/qlogicagent-core",
-  "version": "0.1.5",
-  "description": "Host-neutral qlogicagent tool-loop runtime for server embedding",
+  "version": "0.2.0",
+  "description": "Shared SaaS Agent inference and durable task runtime",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/types/embedded/index.d.ts",
@@ -15,19 +15,13 @@
     "dist/",
     "README.md"
   ],
-  "scripts": {
-    "build": "node scripts/build.mjs",
-    "prepare": "node scripts/build.mjs"
-  },
   "publishConfig": {
     "access": "public"
   },
   "engines": {
     "node": ">=24.0.0 <25"
   },
-  "devDependencies": {
-    "@types/node": "^22.15.0",
-    "esbuild": "^0.28.0",
-    "typescript": "^5.9.3"
+  "scripts": {
+    "build": "node scripts/build.mjs"
   }
-}
+}