@agentium/harness 4.0.0

package/dist/runtime/session-bindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-bindings.d.ts","sourceRoot":"","sources":["../../src/runtime/session-bindings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AACD,MAAM,WAAW,sBAAsB;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IAC9C,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;CACrB;AACD,MAAM,WAAW,mBAAmB;IAClC,IAAI,IAAI,sBAAsB,CAAC;IAC/B,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,sBAAsB,EAAE,UAAU,CAAC,GAAG,IAAI,CAAC;IACjE,OAAO,IAAI,IAAI,CAAC;CACjB;AACD,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,IAAI,sBAAsB;;CAIpC;AACD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,cAAc,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,SAAS,GAAG,aAAa,CAAA;KAAE,CAAC;IAC5G,OAAO,CAAC,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACrF;AACD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtF;AACD,6FAA6F;AAC7F,qBAAa,2BAA4B,YAAW,mBAAmB;IACrE,QAAQ,CAAC,UAAU;;;;MAA+E;IAClG,OAAO,CAAC,OAAO,CAA6C;IAC5D,OAAO,CAAC,MAAM,CAAqB;IAC7B,OAAO,CAAC,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA0BzF,qGAAqG;IACrG,YAAY,CAAC,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI;CAKzF;AACD,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC,KAAK,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AACD,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,KAAK,EAAE,CAAC,CAAC;IACT,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AACD,kGAAkG;AAClG,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAA+E;IAC/F,OAAO,CAAC,OAAO,CAA8C;IACvD,OAAO,CAAC,CAAC,EACb,QAAQ,EAAE,eAAe,EACzB,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,EACjC,UAAU,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GAC3C,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;IA2D7B,YAAY,CAAC,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC;CAoB7F"}

package/dist/runtime/types.d.ts

@@ -0,0 +1,176 @@
+import type { ChatMessage, ModelResponse, RunContext, ToolCallResult, ToolDef } from "@agentium/core";
+import type { HarnessRuntimeBindings, HarnessRuntimeReferences, HarnessRuntimeRegistry } from "./runtime-registry.js";
+export type JsonValue = null | boolean | number | string | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type JsonObject = {
+    [key: string]: JsonValue;
+};
+export interface AbilitySelection {
+    instanceId: string;
+    type: string;
+    version: number;
+    options: JsonObject;
+}
+export interface HarnessDefaults {
+    workspace?: false | {
+        path: string;
+        mode: "read" | "write";
+    };
+    skillDirs?: readonly string[] | false;
+    contextFiles?: boolean;
+    filesystem?: boolean;
+    subagents?: boolean;
+    fileMemory?: boolean;
+    searchPastSessions?: boolean;
+}
+export interface HarnessManifest {
+    contractVersion: 1;
+    runtime?: HarnessRuntimeReferences;
+    id: string;
+    abilities: readonly AbilitySelection[];
+    defaults?: HarnessDefaults;
+    limits?: {
+        toolRoundtrips?: number;
+        maxChildDepth?: number;
+    };
+}
+export interface PromptFragment {
+    id: string;
+    text: string;
+}
+export interface HarnessContextBudget {
+    maxEntries: number;
+    maxBytes: number;
+    maxTokens?: number;
+    deadlineMs: number;
+}
+export interface HarnessContextEntry {
+    id: string;
+    text: string;
+    trust: "host" | "source";
+    source?: {
+        uri: string;
+        version?: string;
+        locator?: string;
+    };
+    expiresAt?: number;
+    estimatedTokens?: number;
+    byteLength: number;
+}
+export interface HarnessContextSource {
+    id: string;
+    fetch: (query: string, ctx: RunContext, budget: HarnessContextBudget) => Promise<readonly HarnessContextEntry[]>;
+}
+export interface HarnessMiddleware {
+    id: string;
+    before?: readonly string[];
+    after?: readonly string[];
+    beforeModel?: (messages: readonly ChatMessage[], ctx: RunContext) => Promise<ChatMessage[]>;
+    afterModel?: (response: ModelResponse, ctx: RunContext) => Promise<void>;
+    afterTool?: (result: ToolCallResult, ctx: RunContext) => Promise<void>;
+}
+export interface AbilityBinding {
+    tools: readonly ToolDef[];
+    promptFragments?: readonly PromptFragment[];
+    contextSources?: readonly HarnessContextSource[];
+    middleware?: readonly HarnessMiddleware[];
+    dispose?: () => Promise<void>;
+}
+export interface AbilityDescription {
+    toolNames: readonly string[];
+    requirements: readonly string[];
+    runtimeDependent?: boolean;
+}
+export interface AbilityFactory {
+    type: string;
+    version: number;
+    validateOptions: (input: JsonObject) => JsonObject;
+    describe: (options: JsonObject) => AbilityDescription;
+    bind: (options: JsonObject, ctx: RunContext) => Promise<AbilityBinding>;
+}
+export interface LocalAbilityUse {
+    instanceId: string;
+    validate: () => void;
+    describe: () => AbilityDescription;
+    bind: (ctx: RunContext) => Promise<AbilityBinding>;
+    portable?: AbilitySelection;
+    /** Trusted factory approved by the creator/host, never recovered from JSON. */
+    factory?: AbilityFactory;
+}
+export type HarnessDefinition = {
+    readonly kind: "portable";
+    readonly manifest: HarnessManifest;
+    readonly factories: readonly AbilityFactory[];
+    readonly runtimeRegistry?: HarnessRuntimeRegistry;
+} | {
+    readonly kind: "local";
+    readonly id?: string;
+    readonly abilities: readonly LocalAbilityUse[];
+    readonly defaults?: HarnessDefaults;
+    readonly limits?: HarnessManifest["limits"];
+    readonly runtime?: HarnessRuntimeBindings;
+    readonly runtimeReferences?: HarnessRuntimeReferences;
+    readonly runtimeRegistry?: HarnessRuntimeRegistry;
+};
+export type HarnessDefinitionInput = HarnessDefinition | {
+    id?: string;
+    abilities?: readonly LocalAbilityUse[];
+    defaults?: HarnessDefaults;
+    limits?: HarnessManifest["limits"];
+    runtime?: HarnessRuntimeBindings;
+    runtimeReferences?: HarnessRuntimeReferences;
+    runtimeRegistry?: HarnessRuntimeRegistry;
+};
+export interface HarnessExtension {
+    runtime?: HarnessRuntimeBindings;
+    runtimeReferences?: HarnessRuntimeReferences;
+    runtimeRegistry?: HarnessRuntimeRegistry;
+    id?: string;
+    abilities?: readonly LocalAbilityUse[];
+    disable?: readonly string[];
+    replaceAbilities?: readonly LocalAbilityUse[];
+    defaults?: HarnessDefaults;
+    limits?: HarnessManifest["limits"];
+}
+export interface HarnessDiagnostic {
+    code: string;
+    path: string;
+    message: string;
+    severity: "info" | "warning" | "error";
+}
+export interface HarnessDescription {
+    id: string;
+    kind: "portable" | "local";
+    contractVersion: 1;
+    abilities: readonly (AbilityDescription & {
+        instanceId: string;
+        type?: string;
+        version?: number;
+    })[];
+    toolNames: readonly string[];
+    requirements: readonly string[];
+    runtimeDependent: boolean;
+    defaults: HarnessDefaults;
+    limits: NonNullable<HarnessManifest["limits"]>;
+    diagnostics: readonly HarnessDiagnostic[];
+}
+export interface HarnessProvenance {
+    path: string;
+    origin: string;
+}
+export interface ResolvedHarness {
+    readonly definition: HarnessDefinition;
+    readonly defaults: HarnessDefaults;
+    readonly limits: NonNullable<HarnessManifest["limits"]>;
+    readonly description: HarnessDescription;
+    readonly provenance: readonly HarnessProvenance[];
+}
+export interface BoundHarness {
+    readonly tools: ToolDef[];
+    readonly promptFragments: PromptFragment[];
+    readonly contextSources: HarnessContextSource[];
+    readonly middleware: HarnessMiddleware[];
+    dispose: () => Promise<readonly HarnessDiagnostic[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/runtime/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/runtime/types.ts"],"names":[],"mappings":"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"}

package/dist/testing.cjs

@@ -0,0 +1,67 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_driver = require("./driver-Cr2BGG4h.cjs");
+let node_crypto = require("node:crypto");
+//#region src/testing.ts
+/** No test-framework dependency. Calls the driver once and throws on violated public lifecycle invariants. */
+async function testDriverContract(driver, config = { grants: {
+	toolIds: [],
+	modelRoles: ["main"]
+} }) {
+	const runtime = new require_driver.HarnessRuntime({
+		...config,
+		driver
+	});
+	const identity = {
+		tenantId: "fixture",
+		userId: "fixture"
+	};
+	const sessionId = `conformance:${(0, node_crypto.randomUUID)()}`;
+	const handle = runtime.start("Conformance fixture", {
+		identity,
+		sessionId
+	});
+	let failed = false;
+	let failure;
+	let report;
+	try {
+		const events = [];
+		for await (const event of handle.events()) events.push(event);
+		const result = await handle.result();
+		const terminal = events.filter((event) => event.payload.type === "run.terminal");
+		if (terminal.length !== 1 || terminal[0].payload.type !== "run.terminal") throw new Error("Expected exactly one terminal event");
+		if (JSON.stringify(terminal[0].payload.result) !== JSON.stringify(result)) throw new Error("Terminal result differs from settled result");
+		if (events.some((event, index) => event.sequence !== index + 1 || event.runId !== handle.runId || event.schemaVersion !== 1)) throw new Error("Invalid event identity/ordering");
+		if (result.finalCursor !== events.at(-1)?.sequence) throw new Error("Invalid final event cursor");
+		if (result.status === "failed") throw new Error(`Driver fixture failed: ${result.reason?.message}`);
+		if (!(await handle.events({ after: result.finalCursor }).next()).done) throw new Error("Terminal event stream remained open");
+		handle.cancel("Late cancellation must not replace success");
+		if (JSON.stringify(await handle.result()) !== JSON.stringify(result)) throw new Error("Settled result changed");
+		report = {
+			result,
+			eventCount: events.length
+		};
+	} catch (error) {
+		failed = true;
+		handle.cancel("Driver conformance failed");
+		failure = error;
+	} finally {
+		await handle.result().catch(() => {});
+		try {
+			const failures = await runtime.resources.closeSession(identity, sessionId);
+			if (failures.length && !failed) {
+				failed = true;
+				failure = /* @__PURE__ */ new Error(`Driver fixture resource cleanup failed: ${failures.join(", ")}`);
+			}
+		} catch (error) {
+			if (!failed) {
+				failed = true;
+				failure = error;
+			}
+		}
+	}
+	if (failed) throw failure;
+	if (!report) throw new Error("Driver fixture did not produce a result");
+	return report;
+}
+//#endregion
+exports.testDriverContract = testDriverContract;

package/dist/testing.d.ts

@@ -0,0 +1,7 @@
+import { type ExecutionDriver, type HarnessResult, type HarnessRuntimeConfig } from "./runtime/index.js";
+/** No test-framework dependency. Calls the driver once and throws on violated public lifecycle invariants. */
+export declare function testDriverContract(driver: ExecutionDriver, config?: Omit<HarnessRuntimeConfig, "driver">): Promise<{
+    result: HarnessResult;
+    eventCount: number;
+}>;
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,aAAa,EAElB,KAAK,oBAAoB,EAC1B,MAAM,oBAAoB,CAAC;AAE5B,8GAA8G;AAC9G,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,eAAe,EACvB,MAAM,GAAE,IAAI,CAAC,oBAAoB,EAAE,QAAQ,CAAqD,GAC/F,OAAO,CAAC;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAoDxD"}

package/dist/testing.js

@@ -0,0 +1,66 @@
+import { n as HarnessRuntime } from "./driver-BvzvqvpB.js";
+import { randomUUID } from "node:crypto";
+//#region src/testing.ts
+/** No test-framework dependency. Calls the driver once and throws on violated public lifecycle invariants. */
+async function testDriverContract(driver, config = { grants: {
+	toolIds: [],
+	modelRoles: ["main"]
+} }) {
+	const runtime = new HarnessRuntime({
+		...config,
+		driver
+	});
+	const identity = {
+		tenantId: "fixture",
+		userId: "fixture"
+	};
+	const sessionId = `conformance:${randomUUID()}`;
+	const handle = runtime.start("Conformance fixture", {
+		identity,
+		sessionId
+	});
+	let failed = false;
+	let failure;
+	let report;
+	try {
+		const events = [];
+		for await (const event of handle.events()) events.push(event);
+		const result = await handle.result();
+		const terminal = events.filter((event) => event.payload.type === "run.terminal");
+		if (terminal.length !== 1 || terminal[0].payload.type !== "run.terminal") throw new Error("Expected exactly one terminal event");
+		if (JSON.stringify(terminal[0].payload.result) !== JSON.stringify(result)) throw new Error("Terminal result differs from settled result");
+		if (events.some((event, index) => event.sequence !== index + 1 || event.runId !== handle.runId || event.schemaVersion !== 1)) throw new Error("Invalid event identity/ordering");
+		if (result.finalCursor !== events.at(-1)?.sequence) throw new Error("Invalid final event cursor");
+		if (result.status === "failed") throw new Error(`Driver fixture failed: ${result.reason?.message}`);
+		if (!(await handle.events({ after: result.finalCursor }).next()).done) throw new Error("Terminal event stream remained open");
+		handle.cancel("Late cancellation must not replace success");
+		if (JSON.stringify(await handle.result()) !== JSON.stringify(result)) throw new Error("Settled result changed");
+		report = {
+			result,
+			eventCount: events.length
+		};
+	} catch (error) {
+		failed = true;
+		handle.cancel("Driver conformance failed");
+		failure = error;
+	} finally {
+		await handle.result().catch(() => {});
+		try {
+			const failures = await runtime.resources.closeSession(identity, sessionId);
+			if (failures.length && !failed) {
+				failed = true;
+				failure = /* @__PURE__ */ new Error(`Driver fixture resource cleanup failed: ${failures.join(", ")}`);
+			}
+		} catch (error) {
+			if (!failed) {
+				failed = true;
+				failure = error;
+			}
+		}
+	}
+	if (failed) throw failure;
+	if (!report) throw new Error("Driver fixture did not produce a result");
+	return report;
+}
+//#endregion
+export { testDriverContract };

package/dist/watch/definition.d.ts

@@ -0,0 +1,11 @@
+import type { WatchDefinition, WatchDefinitionInput } from "./types.js";
+export declare function watchId(value: unknown): asserts value is string;
+/** Pure definition: validates/copies JSON, without binding services or activating anything. */
+export declare function defineWatch(input: WatchDefinitionInput): WatchDefinition;
+export declare function describeWatch(definition: WatchDefinitionInput): {
+    definition: WatchDefinition;
+    hash: string;
+    activation: "explicit";
+    modelCalls: false;
+};
+//# sourceMappingURL=definition.d.ts.map

package/dist/watch/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/watch/definition.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAe,MAAM,YAAY,CAAC;AAerF,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAQ/D;AAYD,+FAA+F;AAC/F,wBAAgB,WAAW,CAAC,KAAK,EAAE,oBAAoB,GAAG,eAAe,CAyExE;AACD,wBAAgB,aAAa,CAAC,UAAU,EAAE,oBAAoB;;;;;EAQ7D"}

package/dist/watch/gmail.d.ts

@@ -0,0 +1,104 @@
+import type { WatchIdentity, WatchSource } from "./types.js";
+type Result<T> = Promise<{
+    data: T;
+}>;
+type RequestOptions = {
+    signal: AbortSignal;
+};
+interface GmailMessage {
+    id?: string | null;
+    internalDate?: string | null;
+    snippet?: string | null;
+    payload?: {
+        headers?: Array<{
+            name?: string | null;
+            value?: string | null;
+        }>;
+    } | null;
+}
+/** Structural subset of an already-authenticated Gmail client; no SDK or credentials are loaded. */
+export interface GmailWatchClient {
+    users: {
+        getProfile(params: {
+            userId: string;
+        }, options: RequestOptions): Result<{
+            historyId?: string | null;
+            emailAddress?: string | null;
+        }>;
+        watch(params: {
+            userId: string;
+            requestBody: {
+                topicName: string;
+                labelIds?: string[];
+                labelFilterBehavior?: "INCLUDE";
+            };
+        }, options: RequestOptions): Result<{
+            historyId?: string | null;
+            expiration?: string | null;
+        }>;
+        stop(params: {
+            userId: string;
+        }, options: RequestOptions): Promise<unknown>;
+        history: {
+            list(params: {
+                userId: string;
+                startHistoryId: string;
+                historyTypes: string[];
+                maxResults: number;
+                pageToken?: string;
+            }, options: RequestOptions): Result<{
+                historyId?: string | null;
+                nextPageToken?: string | null;
+                history?: Array<{
+                    id?: string | null;
+                    messagesAdded?: Array<{
+                        message?: {
+                            id?: string | null;
+                            labelIds?: string[] | null;
+                        } | null;
+                    }>;
+                }>;
+            }>;
+        };
+        messages: {
+            list(params: {
+                userId: string;
+                maxResults: number;
+                pageToken?: string;
+                labelIds?: string[];
+            }, options: RequestOptions): Result<{
+                messages?: Array<{
+                    id?: string | null;
+                }>;
+                nextPageToken?: string | null;
+            }>;
+            get(params: {
+                userId: string;
+                id: string;
+                format: "metadata";
+                metadataHeaders: string[];
+            }, options: RequestOptions): Result<GmailMessage>;
+        };
+    };
+}
+export interface GmailWatchOptions {
+    id: string;
+    mailbox: string;
+    identity: WatchIdentity;
+    topicName: string;
+    labelIds?: string[];
+    client: GmailWatchClient;
+    /** Host verifies Pub/Sub signature, audience and subscription ownership before decoding. */
+    verifyPush?: (raw: unknown) => Promise<{
+        identity: WatchIdentity;
+        messageId: string;
+        data: {
+            emailAddress: string;
+            historyId: string;
+        };
+    }>;
+}
+/** Optional Gmail source: daily renewal/polling are scheduled by DurableWatch, not in this constructor. */
+export declare function gmailWatchSource(options: GmailWatchOptions): WatchSource;
+export {};
+//# sourceMappingURL=gmail.d.ts.map

package/dist/watch/gmail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gmail.d.ts","sourceRoot":"","sources":["../../src/watch/gmail.ts"],"names":[],"mappings":"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"}

package/dist/watch/quiet-hours.d.ts

@@ -0,0 +1,10 @@
+import type { WatchQuietHours } from "./types.js";
+export declare function watchClock(now: number, timeZone: string): {
+    day: string;
+    minute: number;
+};
+export declare function quietMinute(value: string): number;
+export declare function isWatchQuiet(now: number, timeZone: string, quiet?: WatchQuietHours): boolean;
+/** Scan actual instants: repeated local hours are both quiet; skipped boundaries advance naturally. */
+export declare function nextWatchDelivery(now: number, timeZone: string, quiet?: WatchQuietHours, nextDay?: boolean): number;
+//# sourceMappingURL=quiet-hours.d.ts.map

package/dist/watch/quiet-hours.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quiet-hours.d.ts","sourceRoot":"","sources":["../../src/watch/quiet-hours.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAezF;AACD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIjD;AACD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,eAAe,GAAG,OAAO,CAM5F;AACD,uGAAuG;AACvG,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,eAAe,EAAE,OAAO,UAAQ,GAAG,MAAM,CAOjH"}

package/dist/watch/runtime.d.ts

@@ -0,0 +1,42 @@
+import type { WatchDefinition, WatchDefinitionInput, WatchServices, WatchState } from "./types.js";
+/** A bounded, versioned watch. Construction is inert; all I/O requires an explicit method call. */
+export declare class DurableWatch {
+    private readonly services;
+    readonly definition: WatchDefinition;
+    readonly key: {
+        tenantId: string;
+        taskId: string;
+    };
+    private readonly hash;
+    private readonly supervisor;
+    private readonly connectorVersion;
+    constructor(definition: WatchDefinitionInput, services: WatchServices);
+    private checkBindings;
+    private authorize;
+    private state;
+    private read;
+    private mutate;
+    private ensureRecord;
+    private owned;
+    private scheduleKey;
+    private syncSchedules;
+    private start;
+    private renewAt;
+    private deliveryAt;
+    activate(): Promise<void>;
+    resume(): Promise<void>;
+    inspect(): Promise<WatchState>;
+    pause(): Promise<void>;
+    delete(): Promise<void>;
+    /** Explicit fail-closed rollout. Old pending/unknown sends stay bound to the old definition. */
+    update(definition: WatchDefinitionInput, services?: WatchServices): Promise<DurableWatch>;
+    private validateCursor;
+    trigger(raw: unknown): Promise<void>;
+    poll(): Promise<void>;
+    renew(): Promise<void>;
+    /** Delivers at most one digest. It never retries an unresolved external effect. */
+    flush(): Promise<void>;
+    /** Reconciliation remains available after pause/delete/update; it never dispatches a send. */
+    reconcile(outboxId: string): Promise<void>;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/watch/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/watch/runtime.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EAGpB,aAAa,EACb,UAAU,EACX,MAAM,YAAY,CAAC;AAkBpB,mGAAmG;AACnG,qBAAa,YAAY;IAQrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAP3B,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,GAAG,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAwB;IACnD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;gBAExC,UAAU,EAAE,oBAAoB,EACf,QAAQ,EAAE,aAAa;IA0B1C,OAAO,CAAC,aAAa;YAYP,SAAS;IAKvB,OAAO,CAAC,KAAK;YAIC,IAAI;YAMJ,MAAM;YAaN,YAAY;YAsBZ,KAAK;IAgFnB,OAAO,CAAC,WAAW;YAGL,aAAa;YAiBb,KAAK;IAgCnB,OAAO,CAAC,OAAO;IAGf,OAAO,CAAC,UAAU;IAQZ,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAKzB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAGvB,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;IAI9B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAY7B,gGAAgG;IAC1F,MAAM,CAAC,UAAU,EAAE,oBAAoB,EAAE,QAAQ,GAAE,aAA6B,GAAG,OAAO,CAAC,YAAY,CAAC;IA2C9G,OAAO,CAAC,cAAc;IAIhB,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBpC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmDrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAc5B,mFAAmF;IAC7E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuE5B,8FAA8F;IACxF,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAkBjD"}