@xiaozhiclaw/qlogicagent-core 0.2.0 → 0.4.0

package/dist/types/contracts/chat.d.ts

@@ -19,6 +19,11 @@ export type ContextAnchorCategory = "objective" | "acceptance" | "decision" | "c
 export interface ContextAnchor {
     category: ContextAnchorCategory;
     value: string;
+    /** Product-owned identity and immutable revision; chronological order is not authority. */
+    id?: string;
+    revision?: string;
+    supersedes?: string[];
+    references?: string[];
 }
 /**
  * Canonical Goal/thread facts supplied by the product for one Agent turn.

package/dist/types/embedded/business-contracts.d.ts

@@ -42,9 +42,11 @@ export interface BusinessAssistantContext {
 export interface BusinessGoal {
     id: string;
     description: string;
+    /** Opaque product parameters; Core does not implement domain rules or a universal condition language. */
     criteria: Array<{
         id: string;
         description: string;
+        parameters?: Record<string, unknown>;
     }>;
 }
 export interface BusinessGoalEvidence {
@@ -52,6 +54,11 @@ export interface BusinessGoalEvidence {
         id: string;
         status: "satisfied" | "missing" | "failed";
         references: string[];
+        /** Product explanations, observed facts and exact versions for evidence-driven correction. */
+        detail?: string;
+        expected?: unknown;
+        observed?: unknown;
+        revision?: string;
     }>;
 }
 export interface BusinessGoalOutcome extends BusinessGoalEvidence {

package/dist/types/embedded/cloud-agent.d.ts

@@ -1,4 +1,5 @@
 import type { ModelOperation } from "./model-operation.js";
+import type { TaskMonetaryBudget } from "../runtime/ports/model-transport-contracts.js";
 import { type BusinessAssistantContext, type BusinessGoal } from "./business-contracts.js";
 import { type AgentContentBlock } from "./content-blocks.js";
 import type { CreateEmbeddedAgentOptions, ToolResult, TurnCheckpoint, TurnEvent, TurnRequest, LLMRequest } from "./contracts.js";
@@ -17,6 +18,8 @@ export interface CloudToolInvocation {
     round: number;
     name: string;
     arguments: string;
+    /** Product-paid tools must forward this same immutable ceiling to their billing service. */
+    taskBudget?: Readonly<TaskMonetaryBudget>;
 }
 export interface CloudCheckpoint extends TurnCheckpoint {
     schemaVersion: 1;
@@ -35,6 +38,7 @@ export interface CloudTurnRequest extends Omit<TurnRequest, "continuation"> {
     executionBudget?: {
         maxModelRequests?: number;
         deadlineAtMs?: number;
+        monetary?: TaskMonetaryBudget;
     };
 }
 export interface CloudToolWait {

package/dist/types/embedded/cloud-task.d.ts

@@ -1,7 +1,7 @@
 import { type CloudAgentOptions, type CloudCheckpoint, type CloudExecutionContext, type CloudToolReceipt, type CloudToolWait, type CloudTurnEvent, type CloudTurnRequest } from "./cloud-agent.js";
-import type { ToolResult } from "./contracts.js";
+import type { ToolResult, ChatMessage } from "./contracts.js";
 import type { ModelOperation, ModelRecoveryProof } from "./model-operation.js";
-import { type BusinessGoalEvidence, type BusinessGoalOutcome } from "./business-contracts.js";
+import { type BusinessGoal, type BusinessGoalEvidence, type BusinessGoalOutcome } from "./business-contracts.js";
 export type CloudTaskStatus = "queued" | "running" | "waiting_input" | "waiting_confirmation" | "waiting_external" | "reconciliation_required" | "completed" | "stopped" | "failed" | "cancelled";
 export interface CloudTaskSnapshot {
     id: string;
@@ -20,8 +20,18 @@ export interface CloudTaskSnapshot {
     /** Durable product cancellation intent; reconciliation never resumes subsequent work. */
     cancellationRequested?: boolean;
     outcome?: BusinessGoalOutcome;
+    /** Product-authenticated amendments, retained independently of model context compaction. */
+    /** Optional data is product-owned receipt metadata; only messages enter the model checkpoint. */
+    inputs?: {
+        id: string;
+        messages: ChatMessage[];
+        data?: Record<string, unknown>;
+    }[];
 }
 export type CloudTaskEventPayload = CloudTurnEvent | {
+    type: "goal_verification";
+    outcome: BusinessGoalOutcome;
+} | {
     type: "task_status";
     status: CloudTaskStatus;
 } | {
@@ -68,7 +78,11 @@ export interface CloudTaskRuntimeOptions {
     agent: Omit<CloudAgentOptions, "checkpoints" | "onToolResult" | "onWait" | "onModelOperation">;
     /** Query authoritative product state; an LLM's success text is never completion evidence. */
     verifyGoal?(task: CloudTaskSnapshot): Promise<BusinessGoalEvidence>;
-    authorize(context: CloudExecutionContext, action: "create" | "read" | "execute" | "cancel" | "complete_wait" | "recover"): Promise<void>;
+    /** Product-owned confirmed goals may be established through a tool confirmation receipt. */
+    resolveGoal?(task: CloudTaskSnapshot): Promise<BusinessGoal | undefined>;
+    /** Feed independently checked evidence back through the same loop; no separate correction runner. */
+    goalFeedback?(task: CloudTaskSnapshot, outcome: BusinessGoalOutcome): Promise<ChatMessage[]>;
+    authorize(context: CloudExecutionContext, action: "create" | "read" | "execute" | "cancel" | "complete_wait" | "recover" | "append_input"): Promise<void>;
     /** Validate actual employee approval/input or query the original external job; never trust browser results. */
     authorizeCompletion(task: CloudTaskSnapshot, waitId: string, result: ToolResult): Promise<void>;
     /** Required for interrupted model calls or unresolved effects. The product proves billing/retry safety. */
@@ -87,6 +101,12 @@ export interface CloudTaskRuntime {
     /** Called by the existing product worker, independently from browser subscriptions. */
     execute(context: CloudExecutionContext, id: string, workerSignal?: AbortSignal): Promise<void>;
     cancel(context: CloudExecutionContext, id: string): Promise<CloudTaskSnapshot>;
+    /** Continue a resolved task on explicit user input, preserving its identity and original budgets. */
+    appendInput(context: CloudExecutionContext, id: string, input: {
+        id: string;
+        messages: ChatMessage[];
+        data?: Record<string, unknown>;
+    }): Promise<CloudTaskSnapshot>;
     completeWait(context: CloudExecutionContext, id: string, waitId: string, result: ToolResult): Promise<CloudTaskSnapshot>;
     recover(context: CloudExecutionContext, id: string, receipts?: CloudToolReceipt[]): Promise<CloudTaskSnapshot>;
 }

package/dist/types/embedded/contracts.d.ts

@@ -49,7 +49,10 @@ export interface TurnRequest {
     };
 }
 export interface EmbeddedRuntimeOptions {
-    maxToolResultChars?: number;
+    /** Product-owned model projection; receipts retain the full result. Return undefined to keep it. */
+    projectToolResult?: (message: Readonly<ChatMessage>) => Promise<string | undefined>;
+    /** Evidence or new questions supplied by the product before accepting a model's final answer. */
+    reviewCompletion?: (messages: readonly ChatMessage[], answer: string) => Promise<ChatMessage[]>;
     onCheckpoint?: (checkpoint: TurnCheckpoint) => Promise<void>;
 }
 export interface TurnCheckpoint {

package/dist/types/embedded/index.d.ts

@@ -1,7 +1,9 @@
 export { createEmbeddedAgent } from "./embedded-agent.js";
+export { corePackageVersion } from "./package-version.js";
 export { AgentContentBlockValidationError, analyzeEngineeringFile, createStandardPresentationToolResult, isEngineeringFile, parseAgentContentBlock, standardPresentationToolDefinitions, standardPresentationToolNames, } from "./content-blocks.js";
 export type { ContextAnchor, ContextEnvelope, SemanticToolCapability, ToolIdentity, UsageRecord, UsageSource, AgentLogger, ChatMessage, CreateEmbeddedAgentOptions, EmbeddedAgent, EmbeddedRuntimeOptions, LLMChunk, LLMRequest, LLMTransport, ModelRetryAuthorization, ToolDefinition, ToolInvoker, ToolInvocationContext, ToolResult, TurnCheckpoint, TokenUsage, TurnConfig, TurnEvent, TurnRequest, } from "./contracts.js";
 export type { ModelOperation, ModelRecoveryProof } from "./model-operation.js";
+export type { TaskMonetaryBudget } from "../runtime/ports/model-transport-contracts.js";
 export type { BusinessAssistantContext, BusinessGoal, BusinessGoalEvidence, BusinessGoalOutcome } from "./business-contracts.js";
 export { createCloudAgent, completeCloudToolCheckpoint, canonicalCloudValue } from "./cloud-agent.js";
 export type { CloudAgent, CloudAgentOptions, CloudCheckpoint, CloudExecutionContext, CloudToolInvocation, CloudToolReceipt, CloudToolWait, CloudTurnEvent, CloudTurnRequest, } from "./cloud-agent.js";

package/dist/types/embedded/model-operation.d.ts

@@ -7,6 +7,8 @@ export interface ModelOperation {
     attempt: number;
     requestDigest: string;
     model: string;
+    /** Product transport binding, persisted before I/O; never a credential. */
+    originReference?: string;
     startedAtMs?: number;
     finishedAtMs?: number;
     status: "prepared" | "responding" | "completed" | "rejected" | "unknown";

package/dist/types/embedded/package-version.d.ts

@@ -0,0 +1 @@
+export declare const corePackageVersion: string;

package/dist/types/runtime/ports/agent-runtime-ports.d.ts

@@ -39,6 +39,7 @@ export interface StreamingToolExecutorPortConfig {
     executionTimeoutMsByTool?: ReadonlyMap<string, number>;
 }
 export interface ToolLoopRuntimePorts {
+    reviewCompletion?(messages: readonly ChatMessage[], answer: string): Promise<ChatMessage[]>;
     saveCheckpoint?(checkpoint: {
         turnId: string;
         sessionId: string;

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

@@ -1,6 +1,12 @@
 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";
+/** Immutable product task ceiling, enforced by the model service's financial authority. */
+export interface TaskMonetaryBudget {
+    id: string;
+    currency: "CNY";
+    maxAmount: string;
+}
 export interface LLMRequest {
     /** Stable product execution reference; not a provider-side idempotency guarantee. */
     execution?: {
@@ -8,6 +14,8 @@ export interface LLMRequest {
         requestDigest: string;
         round: number;
         attempt: number;
+        originReference?: string;
+        taskBudget?: TaskMonetaryBudget;
     };
     model: string;
     messages: ChatMessage[];
@@ -82,6 +90,10 @@ export interface AccumulatedToolCall {
     arguments: string;
 }
 export interface LLMTransport {
+    /** True only when every billed dispatch enforces execution.taskBudget durably. */
+    supportsTaskMonetaryBudget?: true;
+    /** Select an opaque, durable transport/account reference before dispatch. No inference or credentials in the reference. */
+    bindModelRequest?(request: LLMRequest, apiKey: string): Promise<string>;
     /** 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. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xiaozhiclaw/qlogicagent-core",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Shared SaaS Agent inference and durable task runtime",
   "type": "module",
   "main": "dist/index.js",