@xiaozhiclaw/qlogicagent-core 0.6.6 → 0.6.8

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

@@ -59,7 +59,9 @@ export interface ChatMessage {
     itemId?: string;
     contextAnchors?: ContextAnchor[];
     /** Derived projection of product facts, replaceable by the context transform. */
-    contextProjection?: "facts";
+    contextProjection?: "facts" | "summary";
+    /** Derived summary text; never an authenticated fact or instruction. */
+    contextSummary?: string;
     /** For assistant messages with tool calls. */
     tool_calls?: ToolCallMessage[];
     /** For tool result messages. */
@@ -138,5 +140,7 @@ export interface ToolDefinition {
         semanticCapability?: SemanticToolCapability;
         /** Tool-specific deadline supplied by the product. */
         executionTimeoutMs?: number;
+        /** Only explicitly independent calls may overlap. Omission is a serial barrier. */
+        executionMode?: "parallel" | "sequential";
     };
 }

package/dist/types/contracts/tool-execution-evidence.d.ts

@@ -16,10 +16,3 @@ export declare function classifyToolFailureKind(result: {
     error?: string;
     details?: Record<string, unknown>;
 }): ToolCallExecutionEvidence["failureKind"];
-export declare function summarizeToolExecutionOutcomes(toolCalls: readonly Pick<ToolCallExecutionEvidence, "name" | "status">[], blockedToolCalls: readonly {
-    name: string;
-    reason: string;
-}[]): {
-    failedTools: string[];
-    blockedTools: string[];
-};

package/dist/types/contracts/turn-event.d.ts

@@ -30,7 +30,7 @@ export type TurnEvent = {
     /** Product-requested pause at a durable model-ready boundary. */
     stopReason?: "paused";
     /** Task success remains unverified unless a higher-level product workflow proves it. */
-    taskOutcome?: "unverified";
+    taskOutcome?: "unverified" | "satisfied" | "incomplete";
     usage?: WireTokenUsage;
     model?: string;
     provider?: string;

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

@@ -0,0 +1,27 @@
+/** Local wall-clock trigger contract; the host supplies its UTC offset explicitly. */
+export type AutomationCalendarSchedule = {
+    frequency: "daily" | "weekly" | "monthly" | "yearly";
+    time: string;
+    weekday?: number;
+    monthDay?: number;
+    month?: number;
+};
+export type AutomationSchedule = AutomationCalendarSchedule | {
+    frequency: "once";
+    at: string;
+} | {
+    frequency: "interval";
+    every: number;
+    unit: "minutes" | "hours";
+    startAt: string;
+};
+export interface AutomationOccurrence {
+    scheduledAt: string;
+    scheduledDay: string;
+}
+export declare function validAutomationSchedule(value: unknown): value is AutomationSchedule;
+/** Latest due occurrence, including the preceding calendar occurrence before today's trigger.
+ * No timers, persistence, catch-up jobs, business reporting windows or external effects.
+ * Hosts atomically deduplicate scheduledAt in their own authenticated occurrence store.
+ * Offsets are fixed: a host using daylight-saving rules must resolve the relevant offset. */
+export declare function automationOccurrence(schedule: AutomationSchedule, now: Date, utcOffsetMinutes: number): AutomationOccurrence | null;

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

@@ -87,7 +87,7 @@ export interface CloudTaskRuntimeOptions {
     verifyGoal?(task: CloudTaskSnapshot): Promise<BusinessGoalEvidence>;
     /** 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. */
+    /** Override generic evidence feedback, or return [] to stop. Omission uses the same loop's default correction. */
     goalFeedback?(task: CloudTaskSnapshot, outcome: BusinessGoalOutcome): Promise<ChatMessage[]>;
     authorize(context: CloudExecutionContext, action: "create" | "read" | "execute" | "cancel" | "complete_wait" | "recover" | "append_input" | "resume"): Promise<void>;
     /** Validate product-authorized approval/input or query the original external job; never trust browser results. */

package/dist/types/embedded/context-projection.d.ts

@@ -1,3 +1,5 @@
 import type { ChatMessage, EmbeddedRuntimeOptions, ModelContextPreparation, ModelContextProjection } from "./contracts.js";
 /** Reuse the canonical fallback after product retrieval; token estimates are advisory. */
 export declare function prepareSlidingWindowContext(messages: readonly ChatMessage[], context: ModelContextPreparation, countMessageTokens?: EmbeddedRuntimeOptions["countMessageTokens"]): ModelContextProjection;
+/** One projection path for Embedded and Cloud, including original-response replay. */
+export declare function prepareRuntimeContext(messages: readonly ChatMessage[], context: ModelContextPreparation, options: EmbeddedRuntimeOptions): Promise<ModelContextProjection>;

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

@@ -57,6 +57,15 @@ export interface EmbeddedRuntimeOptions {
     prepareContext?: (messages: readonly ChatMessage[], context: ModelContextPreparation) => Promise<ModelContextProjection>;
     /** Model-aware message measurement; the fallback is an advisory estimate. */
     countMessageTokens?: (message: Readonly<ChatMessage>, model: string) => number;
+    /** Incrementally summarize omitted history through the product's metered model service.
+     * The callback owns authorization, billing and cancellation for any inference it performs.
+     * Summaries remain untrusted data in the existing checkpoint, never a second memory store.
+     * prepareContext, when supplied, owns the whole projection instead.
+     */
+    summarizeContext?: (input: {
+        previousSummary?: string;
+        messages: readonly ChatMessage[];
+    }, context: ModelContextPreparation) => Promise<string>;
     /** 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. */
@@ -65,6 +74,8 @@ export interface EmbeddedRuntimeOptions {
 }
 export interface ModelContextPreparation {
     model: string;
+    /** Exact resident schemas; the default projection reserves their input cost. */
+    tools?: readonly ToolDefinition[];
     /** Context capacity after reserving configured output; Infinity when capacity metadata is disabled. */
     inputBudgetTokens: number;
     sessionId: string;

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

@@ -16,5 +16,9 @@ export type { BusinessToolAdapter, BusinessToolPort, BusinessToolObservation } f
 export { createCloudAgent, completeCloudToolCheckpoint, canonicalCloudValue } from "./cloud-agent.js";
 export type { CloudAgent, CloudAgentOptions, CloudCheckpoint, CloudExecutionContext, CloudToolInvocation, CloudToolReceipt, CloudToolWait, CloudTurnEvent, CloudTurnRequest, } from "./cloud-agent.js";
 export { createCloudTaskRuntime } from "./cloud-task.js";
+export { executeWithModelReconnects, rejectedModelRecoveryAvailable, rejectedModelReconnectAvailable } from "./task-recovery.js";
+export type { ModelReconnectOptions } from "./task-recovery.js";
+export { automationOccurrence, validAutomationSchedule } from "./automation.js";
+export type { AutomationSchedule, AutomationCalendarSchedule, AutomationOccurrence } from "./automation.js";
 export type { CloudTaskStore, CloudTaskSnapshot, CloudTaskStatus, CloudTaskClaim, CloudTaskEvent, CloudTaskEventPayload, CloudTaskRuntime, CloudTaskRuntimeOptions, } from "./cloud-task.js";
 export type { AgentContentBlock } from "./content-blocks.js";

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

@@ -0,0 +1,17 @@
+import type { CloudExecutionContext } from "./cloud-agent.js";
+import type { CloudTaskRuntime, CloudTaskSnapshot } from "./cloud-task.js";
+/** Eligibility is not retry authorization. recover() still requires the original owner's proof. */
+export declare function rejectedModelRecoveryAvailable(task: CloudTaskSnapshot): boolean;
+export declare function rejectedModelReconnectAvailable(task: CloudTaskSnapshot, reconnects?: number): boolean;
+export interface ModelReconnectOptions {
+    /** Reconnects after the first attempt, counted from durable operations across worker restarts. */
+    reconnects?: number;
+    initialDelayMs?: number;
+    maxDelayMs?: number;
+    signal?: AbortSignal;
+    /** One explicit host-authorized recovery beyond the automatic allowance, bound to the original request. */
+    operatorRetryRequestId?: string;
+}
+/** Optional product-worker driver over the canonical runtime. It never starts a scheduler,
+ * creates a replacement task or grants authority to replay unknown model/tool effects. */
+export declare function executeWithModelReconnects(runtime: CloudTaskRuntime, context: CloudExecutionContext, id: string, options?: ModelReconnectOptions): Promise<CloudTaskSnapshot>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xiaozhiclaw/qlogicagent-core",
-  "version": "0.6.6",
+  "version": "0.6.8",
   "description": "Shared SaaS Agent inference and durable task runtime",
   "type": "module",
   "main": "dist/index.js",
@@ -9,6 +9,15 @@
     ".": {
       "types": "./dist/types/embedded/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./automation": {
+      "types": "./dist/types/embedded/automation.d.ts",
+      "default": "./dist/automation.js"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "automation": ["dist/types/embedded/automation.d.ts"]
     }
   },
   "files": [