@elizaos/agent 2.0.3-beta.2 → 2.0.3-beta.3

package/services/approval/types.d.ts

@@ -0,0 +1,207 @@
+/**
+ * Approval-queue transport types — the runtime contract for the
+ * `approval_requests` table (owned by `@elizaos/plugin-sql`, public schema).
+ *
+ * These are agent-private (no plugin dependency): the `book_travel` payload's
+ * travel sub-shapes are declared structurally here rather than importing the
+ * Duffel/travel types from `@elizaos/plugin-personal-assistant` — the runtime
+ * state machine + SQL + validation only need the structural shape. PA keeps its
+ * own precisely-typed `approval-queue.types.ts` for the travel/Duffel domain
+ * reads; the structural overlap means PA's precise payloads remain assignable
+ * to this contract when enqueuing through the runtime {@link ApprovalQueue}.
+ */
+export type ApprovalRequestState = "pending" | "approved" | "executing" | "done" | "rejected" | "expired";
+export type ApprovalAction = "send_message" | "send_email" | "schedule_event" | "modify_event" | "cancel_event" | "book_travel" | "make_call" | "sign_document" | "execute_workflow" | "spend_money";
+export type ApprovalChannel = "telegram" | "discord" | "slack" | "imessage" | "sms" | "x_dm" | "email" | "google_calendar" | "browser" | "phone" | "internal";
+/** Travel passenger record — structural shape; see module docstring. */
+export interface ApprovalTravelPassenger {
+    readonly offerPassengerId?: string | null;
+    readonly givenName: string;
+    readonly familyName: string;
+    readonly bornOn: string;
+    readonly email?: string | null;
+    readonly phoneNumber?: string | null;
+    readonly title?: string | null;
+    readonly gender?: string | null;
+}
+/** Travel calendar-sync plan — structural shape; see module docstring. */
+export interface ApprovalTravelCalendarSync {
+    readonly enabled: boolean;
+    readonly calendarId?: string | null;
+    readonly title?: string | null;
+    readonly description?: string | null;
+    readonly location?: string | null;
+    readonly timeZone?: string | null;
+}
+export type ApprovalPayload = {
+    action: "send_message";
+    recipient: string;
+    body: string;
+    replyToMessageId: string | null;
+} | {
+    action: "send_email";
+    to: ReadonlyArray<string>;
+    cc: ReadonlyArray<string>;
+    bcc: ReadonlyArray<string>;
+    subject: string;
+    body: string;
+    threadId: string | null;
+    replyToMessageId?: string | null;
+} | {
+    action: "schedule_event";
+    calendarId: string;
+    title: string;
+    startsAtMs: number;
+    endsAtMs: number;
+    attendees: ReadonlyArray<string>;
+    location: string | null;
+    description: string | null;
+} | {
+    action: "modify_event";
+    calendarId: string;
+    eventId: string;
+    patch: {
+        title: string | null;
+        startsAtMs: number | null;
+        endsAtMs: number | null;
+        attendees: ReadonlyArray<string> | null;
+        location: string | null;
+        description: string | null;
+    };
+} | {
+    action: "cancel_event";
+    calendarId: string;
+    eventId: string;
+    notifyAttendees: boolean;
+} | {
+    action: "book_travel";
+    kind: "flight" | "hotel" | "ground";
+    provider: string;
+    itineraryRef: string;
+    totalCents: number;
+    currency: string;
+    offerId?: string | null;
+    offerRequestId?: string | null;
+    orderType?: "hold" | "instant" | null;
+    /** Opaque flight-search context (Duffel `SearchFlightsRequest` in PA). */
+    search?: Readonly<Record<string, unknown>> | null;
+    passengers?: ReadonlyArray<ApprovalTravelPassenger>;
+    calendarSync?: ApprovalTravelCalendarSync | null;
+    summary?: string | null;
+    /** Server-side cost breakdown surfaced to the user alongside any
+     *  payment-required prompt. Mirrors `DuffelCallCost`; held as a
+     *  loose record here so the approval-queue type doesn't have to
+     *  depend on the travel-adapter package. */
+    cost?: {
+        readonly totalUsd: number;
+        readonly creatorMarkupUsd: number;
+        readonly platformFeeUsd: number;
+        readonly markupPercent: number | null;
+    } | null;
+    /** Set when an x402 PaymentRequiredError fired before the booking
+     *  could be quoted. The user sees both the booking intent and the
+     *  top-up prompt in a single approval entry. */
+    paymentRequired?: {
+        readonly amount: string;
+        readonly asset: string;
+        readonly network: string;
+        readonly payTo: string;
+        readonly scheme: string;
+        readonly expiresAt: string | null;
+        readonly description: string | null;
+    } | null;
+} | {
+    action: "make_call";
+    to: string;
+    script: string;
+    maxDurationSeconds: number;
+} | {
+    action: "sign_document";
+    documentId: string;
+    documentName: string;
+    signatureUrl: string;
+    deadline: string;
+} | {
+    action: "execute_workflow";
+    workflowId: string;
+    input: Readonly<Record<string, string | number | boolean>>;
+} | {
+    action: "spend_money";
+    vendor: string;
+    amountCents: number;
+    currency: string;
+    memo: string;
+};
+/** Persisted approval request. */
+export interface ApprovalRequest {
+    readonly id: string;
+    readonly createdAt: Date;
+    readonly updatedAt: Date;
+    readonly state: ApprovalRequestState;
+    readonly requestedBy: string;
+    readonly subjectUserId: string;
+    readonly action: ApprovalAction;
+    readonly payload: ApprovalPayload;
+    readonly channel: ApprovalChannel;
+    readonly reason: string;
+    readonly expiresAt: Date;
+    readonly resolvedAt: Date | null;
+    readonly resolvedBy: string | null;
+    readonly resolutionReason: string | null;
+}
+/** Input to `enqueue` — server fills in id, timestamps, and initial state. */
+export interface ApprovalEnqueueInput {
+    readonly requestedBy: string;
+    readonly subjectUserId: string;
+    readonly action: ApprovalAction;
+    readonly payload: ApprovalPayload;
+    readonly channel: ApprovalChannel;
+    readonly reason: string;
+    readonly expiresAt: Date;
+}
+/** Filter for `list`. All fields combine with AND. */
+export interface ApprovalListFilter {
+    readonly subjectUserId: string | null;
+    readonly state: ApprovalRequestState | null;
+    readonly action: ApprovalAction | null;
+    readonly limit: number;
+}
+/** Resolution input for `approve` / `reject`. */
+export interface ApprovalResolution {
+    readonly resolvedBy: string;
+    readonly resolutionReason: string;
+}
+/** Thrown when a state transition is invalid. */
+export declare class ApprovalStateTransitionError extends Error {
+    readonly requestId: string;
+    readonly from: ApprovalRequestState;
+    readonly to: ApprovalRequestState;
+    constructor(requestId: string, from: ApprovalRequestState, to: ApprovalRequestState);
+}
+/** Thrown when an operation references an unknown request id. */
+export declare class ApprovalNotFoundError extends Error {
+    readonly requestId: string;
+    constructor(requestId: string);
+}
+/**
+ * Queue interface. Implementations must:
+ *  - Reject invalid state transitions by throwing `ApprovalStateTransitionError`.
+ *  - Reject unknown ids by throwing `ApprovalNotFoundError`.
+ *  - Use the structured logger only (no `console.*`).
+ *  - Treat `purgeExpired` as idempotent.
+ */
+export interface ApprovalQueue {
+    enqueue(input: ApprovalEnqueueInput): Promise<ApprovalRequest>;
+    list(filter: ApprovalListFilter): Promise<ReadonlyArray<ApprovalRequest>>;
+    byId(id: string): Promise<ApprovalRequest | null>;
+    approve(id: string, resolution: ApprovalResolution): Promise<ApprovalRequest>;
+    reject(id: string, resolution: ApprovalResolution): Promise<ApprovalRequest>;
+    markExecuting(id: string): Promise<ApprovalRequest>;
+    markDone(id: string): Promise<ApprovalRequest>;
+    markExpired(id: string): Promise<ApprovalRequest>;
+    purgeExpired(now: Date): Promise<ReadonlyArray<string>>;
+}
+export interface ApprovalQueueOptions {
+    readonly agentId: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/services/approval/types.d.ts.map

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

package/services/approval/types.js

@@ -0,0 +1,34 @@
+/**
+ * Approval-queue transport types — the runtime contract for the
+ * `approval_requests` table (owned by `@elizaos/plugin-sql`, public schema).
+ *
+ * These are agent-private (no plugin dependency): the `book_travel` payload's
+ * travel sub-shapes are declared structurally here rather than importing the
+ * Duffel/travel types from `@elizaos/plugin-personal-assistant` — the runtime
+ * state machine + SQL + validation only need the structural shape. PA keeps its
+ * own precisely-typed `approval-queue.types.ts` for the travel/Duffel domain
+ * reads; the structural overlap means PA's precise payloads remain assignable
+ * to this contract when enqueuing through the runtime {@link ApprovalQueue}.
+ */
+/** Thrown when a state transition is invalid. */
+export class ApprovalStateTransitionError extends Error {
+    requestId;
+    from;
+    to;
+    constructor(requestId, from, to) {
+        super(`[ApprovalQueue] invalid transition for request ${requestId}: ${from} -> ${to}`);
+        this.name = "ApprovalStateTransitionError";
+        this.requestId = requestId;
+        this.from = from;
+        this.to = to;
+    }
+}
+/** Thrown when an operation references an unknown request id. */
+export class ApprovalNotFoundError extends Error {
+    requestId;
+    constructor(requestId) {
+        super(`[ApprovalQueue] request not found: ${requestId}`);
+        this.name = "ApprovalNotFoundError";
+        this.requestId = requestId;
+    }
+}

package/services/character-persistence.d.ts

@@ -1,6 +1,6 @@
 import { type IAgentRuntime, Service } from "@elizaos/core";
-import { type ElizaConfig } from "../config/config.ts";
-import { type CharacterHistorySource, type RuntimeCharacterLike } from "./character-history.ts";
+import { type ElizaConfig } from "../config/config.js";
+import { type CharacterHistorySource, type RuntimeCharacterLike } from "./character-history.js";
 export declare const CHARACTER_PERSISTENCE_SERVICE = "eliza_character_persistence";
 type PersistCharacterParams = {
     character?: RuntimeCharacterLike;

package/services/client-chat-sender.d.ts

@@ -8,7 +8,7 @@
  * app reconnects.
  */
 import { type IAgentRuntime } from "@elizaos/core";
-import type { ServerState } from "../api/server-types.ts";
+import type { ServerState } from "../api/server-types.js";
 /**
  * Register the `client_chat` send handler on the given runtime.
  *

package/services/config-plugin-manager.d.ts

@@ -1,5 +1,5 @@
-import type { ElizaConfig } from "../config/types.eliza.ts";
-import type { PluginManagerLike } from "./plugin-manager-types.ts";
+import type { ElizaConfig } from "../config/types.eliza.js";
+import type { PluginManagerLike } from "./plugin-manager-types.js";
 type ConfigGetter = () => ElizaConfig;
 export declare function createConfigPluginManager(getConfig: ConfigGetter): PluginManagerLike;
 export {};

package/services/connector-setup-service.d.ts

@@ -10,7 +10,7 @@
  * so connector plugins don't need to import agent internals.
  */
 import { type IAgentRuntime, Service } from "@elizaos/core";
-import { type OwnerContactUpdate } from "../api/owner-contact-helpers.ts";
+import { type OwnerContactUpdate } from "../api/owner-contact-helpers.js";
 export type { OwnerContactUpdate };
 export interface ConnectorSetupServiceInstance extends Service {
     /** Load the current Eliza config from disk. */

package/services/cove-quote-x509.d.ts

@@ -20,7 +20,7 @@
  * SHA-384 (or other) digests and the optional SVN, then mapped into the
  * normalized `TeeEvidence` shape so the same policy evaluator consumes them.
  */
-import { type TeeEvidence } from "./tee-evidence.ts";
+import { type TeeEvidence } from "./tee-evidence.js";
 /** TCG DICE `DiceTcbInfo` extension OID: tcg(2.23.133) platformClass(5) 4. */
 export declare const TCG_DICE_TCB_INFO_OID = "2.23.133.5.4";
 /** Ed25519 signature/key algorithm OID (RFC 8410). */

package/services/cove-quote.d.ts

@@ -26,7 +26,7 @@
  * verifier here is the reference the silicon reproduces. The TBS canonical form
  * is the documented contract (see `canonicalTbsBytes`).
  */
-import { type TeeEvidence, type TeeMeasurementName } from "./tee-evidence.ts";
+import { type TeeEvidence, type TeeMeasurementName } from "./tee-evidence.js";
 /** Measurement registers a CoVE quote carries (RTMR-equivalents). */
 export type CoveMeasurements = {
     /** RoT boot register: extend over rom || lifecycle || BL1 || BL2. */
@@ -185,5 +185,5 @@ export declare function coveQuoteToTeeEvidence(result: Extract<CoveVerifyResult,
  * This is an additional accepted evidence format; the canonical-JSON path above
  * is unchanged. See `cove-quote-x509.ts`.
  */
-export { type CoveX509Cert, type CoveX509VerifyFailure, type CoveX509VerifyOptions, type CoveX509VerifyResult, coveX509ToTeeEvidence, type DiceFwId, type DiceTcbInfo, decodeDiceTcbInfoFromCert, ED25519_OID, SHA384_OID, TCG_DICE_TCB_INFO_OID, verifyCoveX509Chain, } from "./cove-quote-x509.ts";
+export { type CoveX509Cert, type CoveX509VerifyFailure, type CoveX509VerifyOptions, type CoveX509VerifyResult, coveX509ToTeeEvidence, type DiceFwId, type DiceTcbInfo, decodeDiceTcbInfoFromCert, ED25519_OID, SHA384_OID, TCG_DICE_TCB_INFO_OID, verifyCoveX509Chain, } from "./cove-quote-x509.js";
 //# sourceMappingURL=cove-quote.d.ts.map

package/services/dstack-tee-provider.d.ts

@@ -1,4 +1,4 @@
-import { type TeeEvidence } from "./tee-evidence.ts";
+import { type TeeEvidence } from "./tee-evidence.js";
 export type DstackTeeProviderOptions = {
     endpointUrl?: string;
     evidencePath?: string;

package/services/file-storage.d.ts

@@ -0,0 +1,20 @@
+import { Buffer } from "node:buffer";
+import { type IAgentRuntime, IFileStorageService, type StoredFile, type StoredFileListItem } from "@elizaos/core";
+/**
+ * Local-disk, content-addressed implementation of {@link IFileStorageService},
+ * wrapping the agent media store (`${STATE_DIR}/media/<sha256>.<ext>`). This is
+ * the default file-storage backend; a cloud-backed implementation can fill the
+ * same `ServiceType.REMOTE_FILES` slot later without callers changing.
+ */
+export declare class LocalFileStorageService extends IFileStorageService {
+    readonly capabilityDescription = "Local content-addressed file storage (store, serve, list, delete) backed by the agent media store.";
+    static start(runtime: IAgentRuntime): Promise<LocalFileStorageService>;
+    stop(): Promise<void>;
+    store(bytes: Buffer | Uint8Array, mimeType: string): Promise<StoredFile>;
+    storeDataUrl(dataUrl: string): Promise<StoredFile | null>;
+    getUrl(fileName: string): string | null;
+    exists(fileName: string): Promise<boolean>;
+    list(): Promise<StoredFileListItem[]>;
+    delete(fileName: string): Promise<boolean>;
+}
+//# sourceMappingURL=file-storage.d.ts.map

package/services/file-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-storage.d.ts","sourceRoot":"","sources":["../../src/services/file-storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EACL,KAAK,aAAa,EAClB,mBAAmB,EACnB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACxB,MAAM,eAAe,CAAC;AAUvB;;;;;GAKG;AACH,qBAAa,uBAAwB,SAAQ,mBAAmB;IAC9D,SAAkB,qBAAqB,wGACgE;WAE1F,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAItE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAErB,KAAK,CACT,KAAK,EAAE,MAAM,GAAG,UAAU,EAC1B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,CAAC;IAYhB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAkB/D,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKjC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK1C,IAAI,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAWrC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGjD"}

package/services/file-storage.js

@@ -0,0 +1,70 @@
+import { Buffer } from "node:buffer";
+import { IFileStorageService, } from "@elizaos/core";
+import { deleteMediaFile, listMediaFiles, mediaFileNameFromUrl, persistMediaBytes, } from "../api/media-store.js";
+const DATA_URL_RE = /^data:([^;,]*)(;base64)?,([\s\S]*)$/;
+/**
+ * Local-disk, content-addressed implementation of {@link IFileStorageService},
+ * wrapping the agent media store (`${STATE_DIR}/media/<sha256>.<ext>`). This is
+ * the default file-storage backend; a cloud-backed implementation can fill the
+ * same `ServiceType.REMOTE_FILES` slot later without callers changing.
+ */
+export class LocalFileStorageService extends IFileStorageService {
+    capabilityDescription = "Local content-addressed file storage (store, serve, list, delete) backed by the agent media store.";
+    static async start(runtime) {
+        return new LocalFileStorageService(runtime);
+    }
+    async stop() { }
+    async store(bytes, mimeType) {
+        const buffer = Buffer.isBuffer(bytes) ? bytes : Buffer.from(bytes);
+        const persisted = persistMediaBytes(buffer, mimeType);
+        return {
+            url: persisted.url,
+            hash: persisted.hash,
+            fileName: persisted.fileName,
+            mimeType,
+            size: buffer.length,
+        };
+    }
+    async storeDataUrl(dataUrl) {
+        const match = DATA_URL_RE.exec(dataUrl.trim());
+        if (!match)
+            return null;
+        const mimeType = match[1] || "application/octet-stream";
+        const isBase64 = Boolean(match[2]);
+        const payload = match[3] ?? "";
+        let buffer;
+        try {
+            buffer = isBase64
+                ? Buffer.from(payload, "base64")
+                : Buffer.from(decodeURIComponent(payload), "utf8");
+        }
+        catch {
+            return null;
+        }
+        if (buffer.length === 0)
+            return null;
+        return this.store(buffer, mimeType);
+    }
+    getUrl(fileName) {
+        const url = `/api/media/${fileName}`;
+        return mediaFileNameFromUrl(url) ? url : null;
+    }
+    async exists(fileName) {
+        if (!this.getUrl(fileName))
+            return false;
+        return listMediaFiles().some((file) => file.fileName === fileName);
+    }
+    async list() {
+        return listMediaFiles().map((file) => ({
+            url: file.url,
+            hash: file.hash,
+            fileName: file.fileName,
+            mimeType: file.mimeType,
+            size: file.size,
+            createdAt: file.createdAt,
+        }));
+    }
+    async delete(fileName) {
+        return deleteMediaFile(fileName);
+    }
+}

package/services/global-pause/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Runtime global-pause store: the vacation / pause-mode singleton consulted by
+ * the scheduled-task runner, surfaced through the registered
+ * {@link GlobalPauseService}. Cache-backed (no SQL), single canonical key.
+ */
+export { GLOBAL_PAUSE_SERVICE, GlobalPauseService, resolveGlobalPauseService, } from "./service.js";
+export { createGlobalPauseStore, GLOBAL_PAUSE_CACHE_KEY, type GlobalPauseStatus, type GlobalPauseStore, type GlobalPauseWindow, } from "./store.js";
+//# sourceMappingURL=index.d.ts.map

package/services/global-pause/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/global-pause/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,YAAY,CAAC"}

package/services/global-pause/index.js

@@ -0,0 +1,7 @@
+/**
+ * Runtime global-pause store: the vacation / pause-mode singleton consulted by
+ * the scheduled-task runner, surfaced through the registered
+ * {@link GlobalPauseService}. Cache-backed (no SQL), single canonical key.
+ */
+export { GLOBAL_PAUSE_SERVICE, GlobalPauseService, resolveGlobalPauseService, } from "./service.js";
+export { createGlobalPauseStore, GLOBAL_PAUSE_CACHE_KEY, } from "./store.js";

package/services/global-pause/service.d.ts

@@ -0,0 +1,29 @@
+/**
+ * GlobalPauseService — the runtime-owned vacation / pause-mode singleton,
+ * exposed as a registered runtime service.
+ *
+ * Global pause is a runtime primitive: the scheduled-task runner consults the
+ * store pre-fire via `runtime.getService(...)` rather than constructing the
+ * cache-backed store itself. The service is a thin factory over the per-runtime
+ * {@link GlobalPauseStore}; the store is cache-backed (no SQL), single canonical
+ * key.
+ *
+ * Mirrors `KnowledgeGraphService` (lifecycle + getService accessor).
+ */
+import { type IAgentRuntime, Service } from "@elizaos/core";
+import { type GlobalPauseStore } from "./store.js";
+export declare const GLOBAL_PAUSE_SERVICE = "eliza_global_pause";
+export declare class GlobalPauseService extends Service {
+    static serviceType: string;
+    capabilityDescription: string;
+    static start(runtime: IAgentRuntime): Promise<GlobalPauseService>;
+    stop(): Promise<void>;
+    /** The cache-backed global-pause store for this runtime. */
+    getStore(): GlobalPauseStore;
+}
+/**
+ * Resolve the registered {@link GlobalPauseService}. Returns `null` when the
+ * runtime has not registered it (e.g. the "eliza" plugin is absent).
+ */
+export declare function resolveGlobalPauseService(runtime: IAgentRuntime): GlobalPauseService | null;
+//# sourceMappingURL=service.d.ts.map

package/services/global-pause/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/services/global-pause/service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,KAAK,aAAa,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE3E,eAAO,MAAM,oBAAoB,uBAAuB,CAAC;AAEzD,qBAAa,kBAAmB,SAAQ,OAAO;IAC7C,OAAgB,WAAW,SAAwB;IAE1C,qBAAqB,SAC2E;WAE5F,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIjE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAE3B,4DAA4D;IAC5D,QAAQ,IAAI,gBAAgB;CAG7B;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,aAAa,GACrB,kBAAkB,GAAG,IAAI,CAE3B"}

package/services/global-pause/service.js

@@ -0,0 +1,34 @@
+/**
+ * GlobalPauseService — the runtime-owned vacation / pause-mode singleton,
+ * exposed as a registered runtime service.
+ *
+ * Global pause is a runtime primitive: the scheduled-task runner consults the
+ * store pre-fire via `runtime.getService(...)` rather than constructing the
+ * cache-backed store itself. The service is a thin factory over the per-runtime
+ * {@link GlobalPauseStore}; the store is cache-backed (no SQL), single canonical
+ * key.
+ *
+ * Mirrors `KnowledgeGraphService` (lifecycle + getService accessor).
+ */
+import { Service } from "@elizaos/core";
+import { createGlobalPauseStore } from "./store.js";
+export const GLOBAL_PAUSE_SERVICE = "eliza_global_pause";
+export class GlobalPauseService extends Service {
+    static serviceType = GLOBAL_PAUSE_SERVICE;
+    capabilityDescription = "Runtime global-pause store: vacation / pause-mode singleton consulted by the scheduler, cache-backed";
+    static async start(runtime) {
+        return new GlobalPauseService(runtime);
+    }
+    async stop() { }
+    /** The cache-backed global-pause store for this runtime. */
+    getStore() {
+        return createGlobalPauseStore(this.runtime);
+    }
+}
+/**
+ * Resolve the registered {@link GlobalPauseService}. Returns `null` when the
+ * runtime has not registered it (e.g. the "eliza" plugin is absent).
+ */
+export function resolveGlobalPauseService(runtime) {
+    return runtime.getService(GLOBAL_PAUSE_SERVICE);
+}

package/services/global-pause/store.d.ts

@@ -0,0 +1,31 @@
+/**
+ * `GlobalPauseStore` — vacation / pause mode singleton.
+ *
+ * Only ONE pause window can be active at a time. The runner consults
+ * `current()` pre-fire; tasks with `respectsGlobalPause: true` skip with
+ * reason `global_pause`; tasks with `respectsGlobalPause: false` (emergencies)
+ * fire anyway. If `endIso` is set on the active window, the runner reschedules
+ * skipped tasks for `endIso` (the user's "resume my routine" moment).
+ *
+ * Backing storage: runtime cache. Single canonical key.
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+export interface GlobalPauseWindow {
+    startIso: string;
+    endIso?: string;
+    reason?: string;
+}
+export interface GlobalPauseStatus {
+    active: boolean;
+    startIso?: string;
+    endIso?: string;
+    reason?: string;
+}
+export interface GlobalPauseStore {
+    set(window: GlobalPauseWindow): Promise<void>;
+    clear(): Promise<void>;
+    current(now?: Date): Promise<GlobalPauseStatus>;
+}
+export declare const GLOBAL_PAUSE_CACHE_KEY = "eliza:lifeops:global-pause:v1";
+export declare function createGlobalPauseStore(runtime: IAgentRuntime): GlobalPauseStore;
+//# sourceMappingURL=store.d.ts.map

package/services/global-pause/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/services/global-pause/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAOnD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACjD;AAED,eAAO,MAAM,sBAAsB,kCAAkC,CAAC;AA+CtE,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,aAAa,GACrB,gBAAgB,CAsClB"}

package/services/global-pause/store.js

@@ -0,0 +1,83 @@
+/**
+ * `GlobalPauseStore` — vacation / pause mode singleton.
+ *
+ * Only ONE pause window can be active at a time. The runner consults
+ * `current()` pre-fire; tasks with `respectsGlobalPause: true` skip with
+ * reason `global_pause`; tasks with `respectsGlobalPause: false` (emergencies)
+ * fire anyway. If `endIso` is set on the active window, the runner reschedules
+ * skipped tasks for `endIso` (the user's "resume my routine" moment).
+ *
+ * Backing storage: runtime cache. Single canonical key.
+ */
+export const GLOBAL_PAUSE_CACHE_KEY = "eliza:lifeops:global-pause:v1";
+function isValidIso(value) {
+    if (typeof value !== "string" || value.length === 0) {
+        return false;
+    }
+    const ms = Date.parse(value);
+    return Number.isFinite(ms);
+}
+function normalizeWindow(window) {
+    if (!isValidIso(window.startIso)) {
+        throw new Error(`[global-pause] invalid startIso: ${String(window.startIso)}`);
+    }
+    if (window.endIso !== undefined && !isValidIso(window.endIso)) {
+        throw new Error(`[global-pause] invalid endIso: ${String(window.endIso)}`);
+    }
+    if (window.endIso !== undefined &&
+        Date.parse(window.endIso) <= Date.parse(window.startIso)) {
+        throw new Error("[global-pause] endIso must be strictly after startIso");
+    }
+    const normalized = { startIso: window.startIso };
+    if (window.endIso !== undefined) {
+        normalized.endIso = window.endIso;
+    }
+    if (typeof window.reason === "string" && window.reason.trim().length > 0) {
+        normalized.reason = window.reason.trim().slice(0, 200);
+    }
+    return normalized;
+}
+function isWindowActive(window, now) {
+    const startMs = Date.parse(window.startIso);
+    if (!Number.isFinite(startMs) || now.getTime() < startMs) {
+        return false;
+    }
+    if (window.endIso === undefined) {
+        return true;
+    }
+    const endMs = Date.parse(window.endIso);
+    return Number.isFinite(endMs) && now.getTime() < endMs;
+}
+export function createGlobalPauseStore(runtime) {
+    const cache = runtime;
+    return {
+        async set(window) {
+            const normalized = normalizeWindow(window);
+            await cache.setCache(GLOBAL_PAUSE_CACHE_KEY, normalized);
+        },
+        async clear() {
+            await cache.deleteCache(GLOBAL_PAUSE_CACHE_KEY);
+        },
+        async current(now = new Date()) {
+            const stored = await cache.getCache(GLOBAL_PAUSE_CACHE_KEY);
+            if (!stored || typeof stored !== "object") {
+                return { active: false };
+            }
+            if (!isValidIso(stored.startIso)) {
+                return { active: false };
+            }
+            const active = isWindowActive(stored, now);
+            const status = {
+                active,
+                startIso: stored.startIso,
+            };
+            if (stored.endIso !== undefined) {
+                status.endIso = stored.endIso;
+            }
+            if (stored.reason !== undefined) {
+                status.reason = stored.reason;
+            }
+            return status;
+        },
+    };
+}

package/services/handoff/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Runtime handoff store: per-room handoff state gating agent contributions,
+ * surfaced through the registered {@link HandoffService}. Cache-backed (no SQL),
+ * keyed per room.
+ */
+export { HANDOFF_SERVICE, HandoffService, resolveHandoffService, } from "./service.js";
+export { createHandoffStore, describeResumeCondition, evaluateResume, type HandoffEnterOpts, type HandoffStatus, type HandoffStore, type ResumeCondition, type ResumeEvaluation, type ResumeEvaluationInput, } from "./store.js";
+//# sourceMappingURL=index.d.ts.map

package/services/handoff/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/handoff/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,eAAe,EACf,cAAc,EACd,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,cAAc,EACd,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,YAAY,CAAC"}