@undefineds.co/xpod 0.3.48 → 0.3.49

package/dist/api/reconciler/ServerGroupReconcilerService.jsonld

@@ -0,0 +1,146 @@
+{
+  "@context": [
+    "https://linkedsoftwaredependencies.org/bundles/npm/@undefineds.co/xpod/^0.0.0/components/context.jsonld"
+  ],
+  "@id": "npmd:@undefineds.co/xpod",
+  "components": [
+    {
+      "@id": "undefineds:dist/api/reconciler/ServerGroupReconcilerService.jsonld#ServerGroupReconcilerService",
+      "@type": "Class",
+      "requireElement": "ServerGroupReconcilerService",
+      "comment": "Protocol-independent group-room Reconciler.  It decides only whether a group message should enqueue minimal WakeAgentJob records. It does not choose models, providers, workspaces, or tool placement, and it does not create a durable Reconciler Pod resource.",
+      "parameters": [
+        {
+          "@id": "undefineds:dist/api/reconciler/ServerGroupReconcilerService.jsonld#ServerGroupReconcilerService_options",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "undefineds:dist/api/reconciler/ServerGroupReconcilerService.jsonld#ServerGroupReconcilerServiceOptions",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/api/reconciler/ServerGroupReconcilerService.jsonld#ServerGroupReconcilerService__member_wakeQueue",
+          "memberFieldName": "wakeQueue"
+        },
+        {
+          "@id": "undefineds:dist/api/reconciler/ServerGroupReconcilerService.jsonld#ServerGroupReconcilerService__member_now",
+          "memberFieldName": "now"
+        },
+        {
+          "@id": "undefineds:dist/api/reconciler/ServerGroupReconcilerService.jsonld#ServerGroupReconcilerService__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "undefineds:dist/api/reconciler/ServerGroupReconcilerService.jsonld#ServerGroupReconcilerService__member_reconcileThreadMessage",
+          "memberFieldName": "reconcileThreadMessage"
+        },
+        {
+          "@id": "undefineds:dist/api/reconciler/ServerGroupReconcilerService.jsonld#ServerGroupReconcilerService__member_listQueued",
+          "memberFieldName": "listQueued"
+        },
+        {
+          "@id": "undefineds:dist/api/reconciler/ServerGroupReconcilerService.jsonld#ServerGroupReconcilerService__member_close",
+          "memberFieldName": "close"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "undefineds:dist/api/reconciler/ServerGroupReconcilerService.jsonld#ServerGroupReconcilerService_options"
+        }
+      ]
+    },
+    {
+      "@id": "undefineds:dist/api/reconciler/ServerGroupReconcilerService.jsonld#ReconcileGroupThreadMessageInput",
+      "@type": "AbstractClass",
+      "requireElement": "ReconcileGroupThreadMessageInput",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/api/reconciler/ServerGroupReconcilerService.jsonld#ReconcileGroupThreadMessageInput__member_thread",
+          "memberFieldName": "thread"
+        },
+        {
+          "@id": "undefineds:dist/api/reconciler/ServerGroupReconcilerService.jsonld#ReconcileGroupThreadMessageInput__member_triggerMessage",
+          "memberFieldName": "triggerMessage"
+        },
+        {
+          "@id": "undefineds:dist/api/reconciler/ServerGroupReconcilerService.jsonld#ReconcileGroupThreadMessageInput__member_actor",
+          "memberFieldName": "actor"
+        },
+        {
+          "@id": "undefineds:dist/api/reconciler/ServerGroupReconcilerService.jsonld#ReconcileGroupThreadMessageInput__member_role",
+          "memberFieldName": "role"
+        },
+        {
+          "@id": "undefineds:dist/api/reconciler/ServerGroupReconcilerService.jsonld#ReconcileGroupThreadMessageInput__member_content",
+          "memberFieldName": "content"
+        },
+        {
+          "@id": "undefineds:dist/api/reconciler/ServerGroupReconcilerService.jsonld#ReconcileGroupThreadMessageInput__member_reconcilerOwner",
+          "memberFieldName": "reconcilerOwner"
+        },
+        {
+          "@id": "undefineds:dist/api/reconciler/ServerGroupReconcilerService.jsonld#ReconcileGroupThreadMessageInput__member_mentions",
+          "memberFieldName": "mentions"
+        },
+        {
+          "@id": "undefineds:dist/api/reconciler/ServerGroupReconcilerService.jsonld#ReconcileGroupThreadMessageInput__member_routeTargetAgent",
+          "memberFieldName": "routeTargetAgent"
+        },
+        {
+          "@id": "undefineds:dist/api/reconciler/ServerGroupReconcilerService.jsonld#ReconcileGroupThreadMessageInput__member_participants",
+          "memberFieldName": "participants"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/api/reconciler/ServerGroupReconcilerService.jsonld#ReconcileGroupThreadMessageResult",
+      "@type": "AbstractClass",
+      "requireElement": "ReconcileGroupThreadMessageResult",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/api/reconciler/ServerGroupReconcilerService.jsonld#ReconcileGroupThreadMessageResult__member_wakeJobs",
+          "memberFieldName": "wakeJobs"
+        },
+        {
+          "@id": "undefineds:dist/api/reconciler/ServerGroupReconcilerService.jsonld#ReconcileGroupThreadMessageResult__member_inserted",
+          "memberFieldName": "inserted"
+        },
+        {
+          "@id": "undefineds:dist/api/reconciler/ServerGroupReconcilerService.jsonld#ReconcileGroupThreadMessageResult__member_skippedReason",
+          "memberFieldName": "skippedReason"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/api/reconciler/ServerGroupReconcilerService.jsonld#ServerGroupReconcilerServiceOptions",
+      "@type": "AbstractClass",
+      "requireElement": "ServerGroupReconcilerServiceOptions",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/api/reconciler/ServerGroupReconcilerService.jsonld#ServerGroupReconcilerServiceOptions__member_wakeQueue",
+          "memberFieldName": "wakeQueue"
+        },
+        {
+          "@id": "undefineds:dist/api/reconciler/ServerGroupReconcilerService.jsonld#ServerGroupReconcilerServiceOptions__member_redisUrl",
+          "memberFieldName": "redisUrl"
+        },
+        {
+          "@id": "undefineds:dist/api/reconciler/ServerGroupReconcilerService.jsonld#ServerGroupReconcilerServiceOptions__member_now",
+          "memberFieldName": "now"
+        }
+      ],
+      "constructorArguments": []
+    }
+  ]
+}

package/dist/api/reconciler/WakeAgentQueue.d.ts

@@ -0,0 +1,23 @@
+import { type SharedWakeAgentJob } from './coordination';
+export interface WakeAgentEnqueueResult {
+    job: SharedWakeAgentJob;
+    inserted: boolean;
+}
+export interface WakeAgentQueue {
+    enqueue(job: SharedWakeAgentJob): Promise<WakeAgentEnqueueResult>;
+    listQueued(thread: string, agent?: string): Promise<SharedWakeAgentJob[]>;
+    close?(): Promise<void>;
+}
+export interface WakeAgentQueueOptions {
+    redisUrl?: string;
+    namespace?: string;
+}
+export declare function createWakeAgentQueue(options?: WakeAgentQueueOptions): WakeAgentQueue;
+export declare function sharedWakeAgentJobId(input: Pick<SharedWakeAgentJob, 'thread' | 'triggerMessage' | 'agent'>): string;
+export declare function wakeAgentQueueKey(job: Pick<SharedWakeAgentJob, 'thread' | 'agent'>): string;
+export declare class InMemoryWakeAgentQueue implements WakeAgentQueue {
+    private readonly jobsByDedupeKey;
+    private readonly queueKeysByDedupeKey;
+    enqueue(job: SharedWakeAgentJob): Promise<WakeAgentEnqueueResult>;
+    listQueued(thread: string, agent?: string): Promise<SharedWakeAgentJob[]>;
+}

package/dist/api/reconciler/WakeAgentQueue.js

@@ -0,0 +1,123 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryWakeAgentQueue = void 0;
+exports.createWakeAgentQueue = createWakeAgentQueue;
+exports.sharedWakeAgentJobId = sharedWakeAgentJobId;
+exports.wakeAgentQueueKey = wakeAgentQueueKey;
+const node_crypto_1 = require("node:crypto");
+const ioredis_1 = __importDefault(require("ioredis"));
+const global_logger_factory_1 = require("global-logger-factory");
+const coordination_1 = require("./coordination");
+const RedisClientLifecycle_1 = require("../../storage/redis/RedisClientLifecycle");
+function createWakeAgentQueue(options = {}) {
+    return options.redisUrl
+        ? new RedisWakeAgentQueue(options)
+        : new InMemoryWakeAgentQueue();
+}
+function sharedWakeAgentJobId(input) {
+    return `wake_${hash((0, coordination_1.sharedWakeAgentJobDedupeKey)(input))}`;
+}
+function wakeAgentQueueKey(job) {
+    return `steer_queue:${job.thread}:${job.agent}`;
+}
+class InMemoryWakeAgentQueue {
+    constructor() {
+        this.jobsByDedupeKey = new Map();
+        this.queueKeysByDedupeKey = new Map();
+    }
+    async enqueue(job) {
+        const dedupeKey = (0, coordination_1.sharedWakeAgentJobDedupeKey)(job);
+        const existing = this.jobsByDedupeKey.get(dedupeKey);
+        if (existing) {
+            return { job: { ...existing }, inserted: false };
+        }
+        const stored = { ...job };
+        this.jobsByDedupeKey.set(dedupeKey, stored);
+        this.queueKeysByDedupeKey.set(dedupeKey, wakeAgentQueueKey(stored));
+        return { job: { ...stored }, inserted: true };
+    }
+    async listQueued(thread, agent) {
+        return Array.from(this.jobsByDedupeKey.entries())
+            .filter(([dedupeKey, job]) => (job.thread === thread
+            && (!agent || job.agent === agent)
+            && this.queueKeysByDedupeKey.has(dedupeKey)))
+            .map(([, job]) => ({ ...job }));
+    }
+}
+exports.InMemoryWakeAgentQueue = InMemoryWakeAgentQueue;
+class RedisWakeAgentQueue {
+    constructor(options) {
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        this.shuttingDown = false;
+        if (!options.redisUrl) {
+            throw new Error('redisUrl is required for RedisWakeAgentQueue');
+        }
+        this.namespace = options.namespace ?? 'xpod:wake:';
+        this.redis = new ioredis_1.default(options.redisUrl, { lazyConnect: false });
+        (0, RedisClientLifecycle_1.attachRedisClientErrorHandler)(this.redis, {
+            logger: this.logger,
+            label: 'WakeAgentQueue',
+            isShuttingDown: () => this.shuttingDown,
+        });
+    }
+    async enqueue(job) {
+        const dedupeKey = this.dedupeStorageKey(job);
+        const payload = JSON.stringify(job);
+        const inserted = await this.redis.set(dedupeKey, payload, 'NX');
+        if (inserted === 'OK') {
+            await this.redis.rpush(this.queueStorageKey(job.thread, job.agent), payload);
+            await this.redis.sadd(this.threadAgentsKey(job.thread), job.agent);
+            return { job: { ...job }, inserted: true };
+        }
+        const existing = parseJson(await this.redis.get(dedupeKey)) ?? job;
+        return { job: existing, inserted: false };
+    }
+    async listQueued(thread, agent) {
+        const agents = agent ? [agent] : await this.redis.smembers(this.threadAgentsKey(thread));
+        const jobs = [];
+        for (const agent of agents) {
+            const raws = await this.redis.lrange(this.queueStorageKey(thread, agent), 0, -1);
+            for (const raw of raws) {
+                const job = parseJson(raw);
+                if (job) {
+                    jobs.push(job);
+                }
+            }
+        }
+        return jobs;
+    }
+    async close() {
+        this.shuttingDown = true;
+        await (0, RedisClientLifecycle_1.closeRedisClient)(this.redis, {
+            logger: this.logger,
+            label: 'WakeAgentQueue',
+        });
+    }
+    dedupeStorageKey(job) {
+        return `${this.namespace}dedupe:${hash((0, coordination_1.sharedWakeAgentJobDedupeKey)(job))}`;
+    }
+    queueStorageKey(thread, agent) {
+        return `${this.namespace}${wakeAgentQueueKey({ thread, agent })}`;
+    }
+    threadAgentsKey(thread) {
+        return `${this.namespace}thread_agents:${hash(thread)}`;
+    }
+}
+function hash(value) {
+    return (0, node_crypto_1.createHash)('sha256').update(value).digest('hex').slice(0, 32);
+}
+function parseJson(raw) {
+    if (!raw) {
+        return undefined;
+    }
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=WakeAgentQueue.js.map

package/dist/api/reconciler/WakeAgentQueue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WakeAgentQueue.js","sourceRoot":"","sources":["../../../src/api/reconciler/WakeAgentQueue.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from 'node:crypto';\nimport Redis from 'ioredis';\nimport { getLoggerFor } from 'global-logger-factory';\nimport {\n  sharedWakeAgentJobDedupeKey,\n  type SharedWakeAgentJob,\n} from './coordination';\nimport {\n  attachRedisClientErrorHandler,\n  closeRedisClient,\n} from '../../storage/redis/RedisClientLifecycle';\n\nexport interface WakeAgentEnqueueResult {\n  job: SharedWakeAgentJob;\n  inserted: boolean;\n}\n\nexport interface WakeAgentQueue {\n  enqueue(job: SharedWakeAgentJob): Promise<WakeAgentEnqueueResult>;\n  listQueued(thread: string, agent?: string): Promise<SharedWakeAgentJob[]>;\n  close?(): Promise<void>;\n}\n\nexport interface WakeAgentQueueOptions {\n  redisUrl?: string;\n  namespace?: string;\n}\n\nexport function createWakeAgentQueue(options: WakeAgentQueueOptions = {}): WakeAgentQueue {\n  return options.redisUrl\n    ? new RedisWakeAgentQueue(options)\n    : new InMemoryWakeAgentQueue();\n}\n\nexport function sharedWakeAgentJobId(input: Pick<SharedWakeAgentJob, 'thread' | 'triggerMessage' | 'agent'>): string {\n  return `wake_${hash(sharedWakeAgentJobDedupeKey(input))}`;\n}\n\nexport function wakeAgentQueueKey(job: Pick<SharedWakeAgentJob, 'thread' | 'agent'>): string {\n  return `steer_queue:${job.thread}:${job.agent}`;\n}\n\nexport class InMemoryWakeAgentQueue implements WakeAgentQueue {\n  private readonly jobsByDedupeKey = new Map<string, SharedWakeAgentJob>();\n  private readonly queueKeysByDedupeKey = new Map<string, string>();\n\n  public async enqueue(job: SharedWakeAgentJob): Promise<WakeAgentEnqueueResult> {\n    const dedupeKey = sharedWakeAgentJobDedupeKey(job);\n    const existing = this.jobsByDedupeKey.get(dedupeKey);\n    if (existing) {\n      return { job: { ...existing }, inserted: false };\n    }\n    const stored = { ...job };\n    this.jobsByDedupeKey.set(dedupeKey, stored);\n    this.queueKeysByDedupeKey.set(dedupeKey, wakeAgentQueueKey(stored));\n    return { job: { ...stored }, inserted: true };\n  }\n\n  public async listQueued(thread: string, agent?: string): Promise<SharedWakeAgentJob[]> {\n    return Array.from(this.jobsByDedupeKey.entries())\n      .filter(([ dedupeKey, job ]) => (\n        job.thread === thread\n        && (!agent || job.agent === agent)\n        && this.queueKeysByDedupeKey.has(dedupeKey)\n      ))\n      .map(([, job]) => ({ ...job }));\n  }\n}\n\nclass RedisWakeAgentQueue implements WakeAgentQueue {\n  private readonly logger = getLoggerFor(this);\n  private readonly redis: Redis;\n  private readonly namespace: string;\n  private shuttingDown = false;\n\n  public constructor(options: WakeAgentQueueOptions) {\n    if (!options.redisUrl) {\n      throw new Error('redisUrl is required for RedisWakeAgentQueue');\n    }\n    this.namespace = options.namespace ?? 'xpod:wake:';\n    this.redis = new Redis(options.redisUrl, { lazyConnect: false });\n    attachRedisClientErrorHandler(this.redis, {\n      logger: this.logger,\n      label: 'WakeAgentQueue',\n      isShuttingDown: () => this.shuttingDown,\n    });\n  }\n\n  public async enqueue(job: SharedWakeAgentJob): Promise<WakeAgentEnqueueResult> {\n    const dedupeKey = this.dedupeStorageKey(job);\n    const payload = JSON.stringify(job);\n    const inserted = await this.redis.set(dedupeKey, payload, 'NX');\n    if (inserted === 'OK') {\n      await this.redis.rpush(this.queueStorageKey(job.thread, job.agent), payload);\n      await this.redis.sadd(this.threadAgentsKey(job.thread), job.agent);\n      return { job: { ...job }, inserted: true };\n    }\n\n    const existing = parseJson<SharedWakeAgentJob>(await this.redis.get(dedupeKey)) ?? job;\n    return { job: existing, inserted: false };\n  }\n\n  public async listQueued(thread: string, agent?: string): Promise<SharedWakeAgentJob[]> {\n    const agents = agent ? [ agent ] : await this.redis.smembers(this.threadAgentsKey(thread));\n    const jobs: SharedWakeAgentJob[] = [];\n    for (const agent of agents) {\n      const raws = await this.redis.lrange(this.queueStorageKey(thread, agent), 0, -1);\n      for (const raw of raws) {\n        const job = parseJson<SharedWakeAgentJob>(raw);\n        if (job) {\n          jobs.push(job);\n        }\n      }\n    }\n    return jobs;\n  }\n\n  public async close(): Promise<void> {\n    this.shuttingDown = true;\n    await closeRedisClient(this.redis, {\n      logger: this.logger,\n      label: 'WakeAgentQueue',\n    });\n  }\n\n  private dedupeStorageKey(job: Pick<SharedWakeAgentJob, 'thread' | 'triggerMessage' | 'agent'>): string {\n    return `${this.namespace}dedupe:${hash(sharedWakeAgentJobDedupeKey(job))}`;\n  }\n\n  private queueStorageKey(thread: string, agent: string): string {\n    return `${this.namespace}${wakeAgentQueueKey({ thread, agent })}`;\n  }\n\n  private threadAgentsKey(thread: string): string {\n    return `${this.namespace}thread_agents:${hash(thread)}`;\n  }\n}\n\nfunction hash(value: string): string {\n  return createHash('sha256').update(value).digest('hex').slice(0, 32);\n}\n\nfunction parseJson<T>(raw: string | null): T | undefined {\n  if (!raw) {\n    return undefined;\n  }\n  try {\n    return JSON.parse(raw) as T;\n  } catch {\n    return undefined;\n  }\n}\n"]}

package/dist/api/reconciler/WakeAgentQueue.jsonld

@@ -0,0 +1,91 @@
+{
+  "@context": [
+    "https://linkedsoftwaredependencies.org/bundles/npm/@undefineds.co/xpod/^0.0.0/components/context.jsonld"
+  ],
+  "@id": "npmd:@undefineds.co/xpod",
+  "components": [
+    {
+      "@id": "undefineds:dist/api/reconciler/WakeAgentQueue.jsonld#InMemoryWakeAgentQueue",
+      "@type": "Class",
+      "requireElement": "InMemoryWakeAgentQueue",
+      "extends": [
+        "undefineds:dist/api/reconciler/WakeAgentQueue.jsonld#WakeAgentQueue"
+      ],
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/api/reconciler/WakeAgentQueue.jsonld#InMemoryWakeAgentQueue__member_jobsByDedupeKey",
+          "memberFieldName": "jobsByDedupeKey"
+        },
+        {
+          "@id": "undefineds:dist/api/reconciler/WakeAgentQueue.jsonld#InMemoryWakeAgentQueue__member_queueKeysByDedupeKey",
+          "memberFieldName": "queueKeysByDedupeKey"
+        },
+        {
+          "@id": "undefineds:dist/api/reconciler/WakeAgentQueue.jsonld#InMemoryWakeAgentQueue__member_enqueue",
+          "memberFieldName": "enqueue"
+        },
+        {
+          "@id": "undefineds:dist/api/reconciler/WakeAgentQueue.jsonld#InMemoryWakeAgentQueue__member_listQueued",
+          "memberFieldName": "listQueued"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/api/reconciler/WakeAgentQueue.jsonld#WakeAgentEnqueueResult",
+      "@type": "AbstractClass",
+      "requireElement": "WakeAgentEnqueueResult",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/api/reconciler/WakeAgentQueue.jsonld#WakeAgentEnqueueResult__member_job",
+          "memberFieldName": "job"
+        },
+        {
+          "@id": "undefineds:dist/api/reconciler/WakeAgentQueue.jsonld#WakeAgentEnqueueResult__member_inserted",
+          "memberFieldName": "inserted"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/api/reconciler/WakeAgentQueue.jsonld#WakeAgentQueue",
+      "@type": "AbstractClass",
+      "requireElement": "WakeAgentQueue",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/api/reconciler/WakeAgentQueue.jsonld#WakeAgentQueue__member_enqueue",
+          "memberFieldName": "enqueue"
+        },
+        {
+          "@id": "undefineds:dist/api/reconciler/WakeAgentQueue.jsonld#WakeAgentQueue__member_listQueued",
+          "memberFieldName": "listQueued"
+        },
+        {
+          "@id": "undefineds:dist/api/reconciler/WakeAgentQueue.jsonld#WakeAgentQueue__member_close",
+          "memberFieldName": "close"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/api/reconciler/WakeAgentQueue.jsonld#WakeAgentQueueOptions",
+      "@type": "AbstractClass",
+      "requireElement": "WakeAgentQueueOptions",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/api/reconciler/WakeAgentQueue.jsonld#WakeAgentQueueOptions__member_redisUrl",
+          "memberFieldName": "redisUrl"
+        },
+        {
+          "@id": "undefineds:dist/api/reconciler/WakeAgentQueue.jsonld#WakeAgentQueueOptions__member_namespace",
+          "memberFieldName": "namespace"
+        }
+      ],
+      "constructorArguments": []
+    }
+  ]
+}

package/dist/api/reconciler/coordination.d.ts

@@ -0,0 +1,61 @@
+export type ReconcilerOwner = 'client' | 'server';
+export type WakeAgentReason = 'mention' | 'reconciler_decision' | 'manual';
+export type WakeAgentStatus = 'queued' | 'leased' | 'completed' | 'failed';
+export type ClientKind = 'cli' | 'desktop' | 'mobile' | 'web';
+export interface ReconcilerCoordinationMetadata {
+    reconcilerOwner: ReconcilerOwner;
+}
+export interface SharedWakeAgentJob {
+    id: string;
+    thread: string;
+    triggerMessage: string;
+    agent: string;
+    reason: WakeAgentReason;
+    status: WakeAgentStatus;
+    createdAt: string;
+}
+export interface WakeAgentLeaseFields {
+    priority?: 'low' | 'normal' | 'high';
+    leaseOwner?: string;
+    leaseExpiresAt?: string;
+}
+export interface ClientCapability {
+    clientId: string;
+    kind: ClientKind;
+    user: string;
+    canCoordinateClientOwnedThread: boolean;
+    canRunAgent: boolean;
+    workspaces: string[];
+    heartbeatAt: string;
+}
+export interface ClientReconcilerLease {
+    thread: string;
+    ownerClientId: string;
+    ownerUser: string;
+    fencingToken: string;
+    expiresAt: string;
+}
+export interface ClientReconcilerActivationOptions {
+    thread: string;
+    ownerUser: string;
+    clients: ClientCapability[];
+    currentLease?: ClientReconcilerLease;
+    now?: Date;
+    heartbeatTtlMs?: number;
+    leaseTtlMs?: number;
+    fencingToken?: string;
+}
+export declare function activateClientReconciler(options: ClientReconcilerActivationOptions): ClientReconcilerLease | undefined;
+export declare function isReconcilerOwner(value: unknown): value is ReconcilerOwner;
+export declare function normalizeReconcilerOwner(value: unknown, fallback?: ReconcilerOwner): ReconcilerOwner;
+export declare function reconcilerCoordinationMetadata(owner: ReconcilerOwner): ReconcilerCoordinationMetadata;
+export declare function withReconcilerCoordinationMetadata(metadata: Record<string, unknown> | undefined, owner: ReconcilerOwner): Record<string, unknown>;
+export declare function sharedWakeAgentJobDedupeKey(job: Pick<SharedWakeAgentJob, 'thread' | 'triggerMessage' | 'agent'>): string;
+export declare function isClientReconcilerLeaseActive(lease: ClientReconcilerLease | undefined, now?: Date): boolean;
+export declare function clientKindRank(kind: ClientKind): number;
+export declare function selectClientReconcilerClient(clients: ClientCapability[], options: {
+    ownerUser: string;
+    now?: Date;
+    heartbeatTtlMs?: number;
+    currentLease?: ClientReconcilerLease;
+}): ClientCapability | undefined;

package/dist/api/reconciler/coordination.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.activateClientReconciler = activateClientReconciler;
+exports.isReconcilerOwner = isReconcilerOwner;
+exports.normalizeReconcilerOwner = normalizeReconcilerOwner;
+exports.reconcilerCoordinationMetadata = reconcilerCoordinationMetadata;
+exports.withReconcilerCoordinationMetadata = withReconcilerCoordinationMetadata;
+exports.sharedWakeAgentJobDedupeKey = sharedWakeAgentJobDedupeKey;
+exports.isClientReconcilerLeaseActive = isClientReconcilerLeaseActive;
+exports.clientKindRank = clientKindRank;
+exports.selectClientReconcilerClient = selectClientReconcilerClient;
+function activateClientReconciler(options) {
+    const now = options.now ?? new Date();
+    const leaseTtlMs = options.leaseTtlMs ?? 30_000;
+    const selected = selectClientReconcilerClient(options.clients, {
+        ownerUser: options.ownerUser,
+        now,
+        heartbeatTtlMs: options.heartbeatTtlMs,
+        currentLease: options.currentLease,
+    });
+    if (!selected) {
+        return undefined;
+    }
+    const keepCurrentToken = options.currentLease?.ownerClientId === selected.clientId
+        && options.currentLease.ownerUser === options.ownerUser
+        && isClientReconcilerLeaseActive(options.currentLease, now);
+    return {
+        thread: options.thread,
+        ownerClientId: selected.clientId,
+        ownerUser: options.ownerUser,
+        fencingToken: keepCurrentToken
+            ? options.currentLease.fencingToken
+            : (options.fencingToken ?? `${selected.clientId}:${now.toISOString()}`),
+        expiresAt: new Date(now.getTime() + leaseTtlMs).toISOString(),
+    };
+}
+function isReconcilerOwner(value) {
+    return value === 'client' || value === 'server';
+}
+function normalizeReconcilerOwner(value, fallback = 'client') {
+    return isReconcilerOwner(value) ? value : fallback;
+}
+function reconcilerCoordinationMetadata(owner) {
+    return { reconcilerOwner: owner };
+}
+function withReconcilerCoordinationMetadata(metadata, owner) {
+    const { conversationKind: _discardedConversationKind, ...rest } = metadata ?? {};
+    void _discardedConversationKind;
+    return {
+        ...rest,
+        ...reconcilerCoordinationMetadata(owner),
+    };
+}
+function sharedWakeAgentJobDedupeKey(job) {
+    return [job.thread, job.triggerMessage, job.agent].join('|');
+}
+function isClientReconcilerLeaseActive(lease, now = new Date()) {
+    if (!lease) {
+        return false;
+    }
+    const expiresAt = Date.parse(lease.expiresAt);
+    return Number.isFinite(expiresAt) && expiresAt > now.getTime();
+}
+function clientKindRank(kind) {
+    switch (kind) {
+        case 'cli':
+        case 'desktop':
+            return 0;
+        case 'mobile':
+            return 1;
+        case 'web':
+            return 2;
+        default:
+            return 3;
+    }
+}
+function selectClientReconcilerClient(clients, options) {
+    const now = options.now ?? new Date();
+    const heartbeatTtlMs = options.heartbeatTtlMs ?? 30_000;
+    const activeLease = isClientReconcilerLeaseActive(options.currentLease, now)
+        ? options.currentLease
+        : undefined;
+    if (activeLease) {
+        const leaseOwner = clients.find((client) => (client.clientId === activeLease.ownerClientId
+            && client.user === options.ownerUser
+            && client.canCoordinateClientOwnedThread
+            && isClientHeartbeatFresh(client, now, heartbeatTtlMs)));
+        if (leaseOwner) {
+            return leaseOwner;
+        }
+    }
+    return clients
+        .filter((client) => (client.user === options.ownerUser
+        && client.canCoordinateClientOwnedThread
+        && isClientHeartbeatFresh(client, now, heartbeatTtlMs)))
+        .sort(compareClientCapability)[0];
+}
+function isClientHeartbeatFresh(client, now, heartbeatTtlMs) {
+    const heartbeatAt = Date.parse(client.heartbeatAt);
+    return Number.isFinite(heartbeatAt) && now.getTime() - heartbeatAt <= heartbeatTtlMs;
+}
+function compareClientCapability(a, b) {
+    const rank = clientKindRank(a.kind) - clientKindRank(b.kind);
+    if (rank !== 0) {
+        return rank;
+    }
+    return a.clientId.localeCompare(b.clientId);
+}
+//# sourceMappingURL=coordination.js.map

package/dist/api/reconciler/coordination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordination.js","sourceRoot":"","sources":["../../../src/api/reconciler/coordination.ts"],"names":[],"mappings":"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","sourcesContent":["export type ReconcilerOwner = 'client' | 'server';\nexport type WakeAgentReason = 'mention' | 'reconciler_decision' | 'manual';\nexport type WakeAgentStatus = 'queued' | 'leased' | 'completed' | 'failed';\nexport type ClientKind = 'cli' | 'desktop' | 'mobile' | 'web';\n\nexport interface ReconcilerCoordinationMetadata {\n  reconcilerOwner: ReconcilerOwner;\n}\n\nexport interface SharedWakeAgentJob {\n  id: string;\n  thread: string;\n  triggerMessage: string;\n  agent: string;\n  reason: WakeAgentReason;\n  status: WakeAgentStatus;\n  createdAt: string;\n}\n\nexport interface WakeAgentLeaseFields {\n  priority?: 'low' | 'normal' | 'high';\n  leaseOwner?: string;\n  leaseExpiresAt?: string;\n}\n\nexport interface ClientCapability {\n  clientId: string;\n  kind: ClientKind;\n  user: string;\n  canCoordinateClientOwnedThread: boolean;\n  canRunAgent: boolean;\n  workspaces: string[];\n  heartbeatAt: string;\n}\n\nexport interface ClientReconcilerLease {\n  thread: string;\n  ownerClientId: string;\n  ownerUser: string;\n  fencingToken: string;\n  expiresAt: string;\n}\n\nexport interface ClientReconcilerActivationOptions {\n  thread: string;\n  ownerUser: string;\n  clients: ClientCapability[];\n  currentLease?: ClientReconcilerLease;\n  now?: Date;\n  heartbeatTtlMs?: number;\n  leaseTtlMs?: number;\n  fencingToken?: string;\n}\n\nexport function activateClientReconciler(options: ClientReconcilerActivationOptions): ClientReconcilerLease | undefined {\n  const now = options.now ?? new Date();\n  const leaseTtlMs = options.leaseTtlMs ?? 30_000;\n  const selected = selectClientReconcilerClient(options.clients, {\n    ownerUser: options.ownerUser,\n    now,\n    heartbeatTtlMs: options.heartbeatTtlMs,\n    currentLease: options.currentLease,\n  });\n\n  if (!selected) {\n    return undefined;\n  }\n\n  const keepCurrentToken = options.currentLease?.ownerClientId === selected.clientId\n    && options.currentLease.ownerUser === options.ownerUser\n    && isClientReconcilerLeaseActive(options.currentLease, now);\n\n  return {\n    thread: options.thread,\n    ownerClientId: selected.clientId,\n    ownerUser: options.ownerUser,\n    fencingToken: keepCurrentToken\n      ? options.currentLease!.fencingToken\n      : (options.fencingToken ?? `${selected.clientId}:${now.toISOString()}`),\n    expiresAt: new Date(now.getTime() + leaseTtlMs).toISOString(),\n  };\n}\n\nexport function isReconcilerOwner(value: unknown): value is ReconcilerOwner {\n  return value === 'client' || value === 'server';\n}\n\nexport function normalizeReconcilerOwner(value: unknown, fallback: ReconcilerOwner = 'client'): ReconcilerOwner {\n  return isReconcilerOwner(value) ? value : fallback;\n}\n\nexport function reconcilerCoordinationMetadata(owner: ReconcilerOwner): ReconcilerCoordinationMetadata {\n  return { reconcilerOwner: owner };\n}\n\nexport function withReconcilerCoordinationMetadata(\n  metadata: Record<string, unknown> | undefined,\n  owner: ReconcilerOwner,\n): Record<string, unknown> {\n  const { conversationKind: _discardedConversationKind, ...rest } = metadata ?? {};\n  void _discardedConversationKind;\n  return {\n    ...rest,\n    ...reconcilerCoordinationMetadata(owner),\n  };\n}\n\nexport function sharedWakeAgentJobDedupeKey(job: Pick<SharedWakeAgentJob, 'thread' | 'triggerMessage' | 'agent'>): string {\n  return [job.thread, job.triggerMessage, job.agent].join('|');\n}\n\nexport function isClientReconcilerLeaseActive(lease: ClientReconcilerLease | undefined, now: Date = new Date()): boolean {\n  if (!lease) {\n    return false;\n  }\n  const expiresAt = Date.parse(lease.expiresAt);\n  return Number.isFinite(expiresAt) && expiresAt > now.getTime();\n}\n\nexport function clientKindRank(kind: ClientKind): number {\n  switch (kind) {\n    case 'cli':\n    case 'desktop':\n      return 0;\n    case 'mobile':\n      return 1;\n    case 'web':\n      return 2;\n    default:\n      return 3;\n  }\n}\n\nexport function selectClientReconcilerClient(\n  clients: ClientCapability[],\n  options: {\n    ownerUser: string;\n    now?: Date;\n    heartbeatTtlMs?: number;\n    currentLease?: ClientReconcilerLease;\n  },\n): ClientCapability | undefined {\n  const now = options.now ?? new Date();\n  const heartbeatTtlMs = options.heartbeatTtlMs ?? 30_000;\n  const activeLease = isClientReconcilerLeaseActive(options.currentLease, now)\n    ? options.currentLease\n    : undefined;\n\n  if (activeLease) {\n    const leaseOwner = clients.find((client) => (\n      client.clientId === activeLease.ownerClientId\n      && client.user === options.ownerUser\n      && client.canCoordinateClientOwnedThread\n      && isClientHeartbeatFresh(client, now, heartbeatTtlMs)\n    ));\n    if (leaseOwner) {\n      return leaseOwner;\n    }\n  }\n\n  return clients\n    .filter((client) => (\n      client.user === options.ownerUser\n      && client.canCoordinateClientOwnedThread\n      && isClientHeartbeatFresh(client, now, heartbeatTtlMs)\n    ))\n    .sort(compareClientCapability)[0];\n}\n\nfunction isClientHeartbeatFresh(client: ClientCapability, now: Date, heartbeatTtlMs: number): boolean {\n  const heartbeatAt = Date.parse(client.heartbeatAt);\n  return Number.isFinite(heartbeatAt) && now.getTime() - heartbeatAt <= heartbeatTtlMs;\n}\n\nfunction compareClientCapability(a: ClientCapability, b: ClientCapability): number {\n  const rank = clientKindRank(a.kind) - clientKindRank(b.kind);\n  if (rank !== 0) {\n    return rank;\n  }\n  return a.clientId.localeCompare(b.clientId);\n}\n"]}