@xiaozhiclaw/qlogicagent-core 0.6.7 → 0.6.8

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/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/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.7",
+  "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": [