crewly 1.20.209 → 1.20.211

package/dist/backend/backend/src/services/apps/apps-cloud.client.js

@@ -0,0 +1,120 @@
+/**
+ * AppsCloudClient — this instance's calls to the Crewly Apps agent API
+ * (`<cloudUrl>/api/apps/v1`, crewly-services apps/SPEC.md §3.1).
+ *
+ * Authenticates with the Cloud access token the {@link CloudClientService}
+ * holds and refreshes, bound to this instance (`X-Crewly-Instance`) and
+ * attributed to the calling agent (`X-Crewly-Agent`). Agents never see the
+ * token: they reach this through `/api/apps` (specs/2026-10-04-crewly-apps-p2.md).
+ *
+ * @module services/apps/apps-cloud.client
+ */
+import { CREWLY_APPS_CONSTANTS } from '../../constants.js';
+import { CloudClientService } from '../cloud/cloud-client.service.js';
+const C = CREWLY_APPS_CONSTANTS;
+/** A failed Apps call: HTTP status and a stable code for the controller and skills. */
+export class AppsCloudError extends Error {
+    status;
+    code;
+    constructor(status, code, message) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.name = 'AppsCloudError';
+    }
+}
+/**
+ * Typed wrapper over the Apps agent API.
+ */
+export class AppsCloudClient {
+    deps;
+    cloud;
+    fetchImpl;
+    constructor(deps) {
+        this.deps = deps;
+        this.cloud = deps.cloud ?? CloudClientService.getInstance();
+        this.fetchImpl = deps.fetchImpl ?? fetch;
+    }
+    /**
+     * Whether a Cloud login is present (a call can be attempted).
+     *
+     * @returns True when connected with a token and URL
+     */
+    isAvailable() {
+        return this.cloud.isConnected() && !!this.cloud.getToken() && !!this.cloud.getCloudUrl();
+    }
+    /**
+     * Call the Apps API and return its `data`.
+     *
+     * A 401 refreshes the Cloud token once and retries. Cloud's
+     * `{ success:false, error, code }` becomes an {@link AppsCloudError} with
+     * Cloud's status and code. The token is never part of an error.
+     *
+     * @param method - HTTP method
+     * @param path - Path under `/api/apps/v1` (starts with `/`)
+     * @param opts - Body, query, agent attribution
+     * @returns The response `data`
+     * @throws AppsCloudError not_logged_in / instance_unknown / network / Cloud's code
+     */
+    async request(method, path, opts = {}) {
+        if (!this.isAvailable()) {
+            throw new AppsCloudError(409, C.ERROR_CODES.NOT_LOGGED_IN, 'This machine is not signed in to Crewly Cloud. Run `crewly cloud login`.');
+        }
+        const instanceId = await this.deps.instanceId();
+        if (!instanceId) {
+            throw new AppsCloudError(409, C.ERROR_CODES.NO_INSTANCE, 'This machine has no Crewly Cloud instance id yet. Sign in to Crewly Cloud and try again in a minute.');
+        }
+        let res = await this.send(method, path, opts, instanceId);
+        if (res.status === 401 && (await this.cloud.tryRefreshToken().catch(() => false))) {
+            res = await this.send(method, path, opts, instanceId);
+        }
+        const json = await AppsCloudClient.readJson(res);
+        if (res.ok && json && json.success !== false)
+            return json.data;
+        const code = typeof json?.code === 'string' ? json.code : res.status === 401 ? C.ERROR_CODES.NOT_LOGGED_IN : `http_${res.status}`;
+        const message = typeof json?.error === 'string'
+            ? json.error
+            : res.status === 401
+                ? 'Crewly Cloud rejected the session. Run `crewly cloud login` again.'
+                : `Crewly Apps request failed (${res.status}).`;
+        throw new AppsCloudError(res.status === 401 ? 409 : res.status, code, message);
+    }
+    static async readJson(res) {
+        try {
+            const parsed = await res.json();
+            return parsed && typeof parsed === 'object' ? parsed : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    async send(method, path, opts, instanceId) {
+        const base = `${(this.cloud.getCloudUrl() ?? '').replace(/\/+$/, '')}${C.CLOUD_PATH}`;
+        const url = new URL(`${base}${path}`);
+        for (const [k, v] of Object.entries(opts.query ?? {})) {
+            if (v !== undefined && v !== '')
+                url.searchParams.set(k, String(v));
+        }
+        const headers = {
+            Authorization: `Bearer ${this.cloud.getToken() ?? ''}`,
+            'X-Crewly-Instance': instanceId,
+        };
+        if (opts.agent)
+            headers['X-Crewly-Agent'] = opts.agent;
+        if (opts.body !== undefined)
+            headers['Content-Type'] = 'application/json';
+        try {
+            return await this.fetchImpl(url.toString(), {
+                method,
+                headers,
+                ...(opts.body !== undefined ? { body: JSON.stringify(opts.body) } : {}),
+                signal: AbortSignal.timeout(opts.timeoutMs ?? C.REQUEST_TIMEOUT_MS),
+            });
+        }
+        catch (err) {
+            const why = err instanceof Error ? err.name : 'error';
+            throw new AppsCloudError(502, C.ERROR_CODES.NETWORK, `Could not reach Crewly Apps (${why}). Try again shortly.`);
+        }
+    }
+}
+//# sourceMappingURL=apps-cloud.client.js.map

package/dist/backend/backend/src/services/apps/apps-cloud.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apps-cloud.client.js","sourceRoot":"","sources":["../../../../../../backend/src/services/apps/apps-cloud.client.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/services/apps/apps-registry.service.d.ts

@@ -0,0 +1,125 @@
+/**
+ * AppsRegistryService — the apps this instance published, kept in
+ * `<CREWLY_HOME>/apps/registry.json`.
+ *
+ * It answers two questions: which app an agent's publish goes to (so the
+ * same agent republishing the same directory lands on the same app), and
+ * which agent to wake when an app changes. It also keeps each app's change
+ * cursor for the poller (specs/2026-10-04-crewly-apps-p2.md §2, §5).
+ *
+ * @module services/apps/apps-registry.service
+ */
+/** One app this instance published. */
+export interface AppRegistryEntry {
+    appId: string;
+    name: string;
+    url: string;
+    /** The agent woken for this app's changes (the last publisher); null = orchestrator */
+    agentSession: string | null;
+    /** Absolute source directory or file it was published from */
+    source: string | null;
+    currentVersion: number | null;
+    /** Last change seq handled by the poller; null until it first reads the head */
+    cursor: number | null;
+    createdAt: string;
+    updatedAt: string;
+    /** Gone from Cloud (404): no longer polled */
+    deleted?: boolean;
+    /** Last successful wake per recipient (session, or the orchestrator key), epoch ms: the cooldown survives a restart */
+    wakes?: Record<string, number>;
+    /** Seqs above `cursor` already delivered (another batch for this app is still pending): skipped when re-read */
+    delivered?: number[];
+    /** Visitor-triggered wakes on a UTC day, and visitor submissions not delivered over the daily cap (P3 §3) */
+    visitorWakes?: VisitorWakeState;
+}
+/** The daily cap on visitor-triggered wakes (P3 §3). */
+export interface VisitorWakeState {
+    /** UTC day `YYYY-MM-DD` that `count` belongs to */
+    day: string;
+    /** Visitor-triggered wakes delivered that day */
+    count: number;
+    /** Visitor submissions counted but not delivered (over the cap), not yet reported to the agent */
+    skipped: number;
+}
+/** What to look an app up by when publishing. */
+export interface AppLookup {
+    appId?: string;
+    agentSession?: string | null;
+    source?: string | null;
+    name?: string | null;
+}
+/**
+ * File-backed registry. All writes are serialised in-process.
+ */
+export declare class AppsRegistryService {
+    private readonly file;
+    private data;
+    private chain;
+    /**
+     * @param crewlyHome - CREWLY_HOME directory
+     */
+    constructor(crewlyHome: string);
+    private load;
+    private mutate;
+    /**
+     * Every app, deleted ones included.
+     *
+     * @returns Copies of the entries
+     */
+    list(): Promise<AppRegistryEntry[]>;
+    /**
+     * One app by id.
+     *
+     * @param appId - App id
+     * @returns A copy, or null
+     */
+    get(appId: string): Promise<AppRegistryEntry | null>;
+    /**
+     * The app a publish should go to: explicit id; else the same agent and
+     * source; else the same agent and name (case-insensitive). Deleted apps
+     * never match implicitly.
+     *
+     * @param q - Lookup keys
+     * @returns The entry, or null (create a new app)
+     */
+    find(q: AppLookup): Promise<AppRegistryEntry | null>;
+    /**
+     * Insert or update an entry (fields given replace the stored ones).
+     *
+     * @param appId - App id
+     * @param patch - Fields to set
+     * @returns The stored entry
+     */
+    upsert(appId: string, patch: Partial<Omit<AppRegistryEntry, 'appId'>>): Promise<AppRegistryEntry>;
+    /**
+     * Store the poller's progress: the cursor and the seqs above it that were
+     * already delivered (no-op for an unknown app or no change).
+     *
+     * @param appId - App id
+     * @param cursor - Safe cursor (before every undelivered change)
+     * @param delivered - Delivered seqs above the cursor
+     */
+    setProgress(appId: string, cursor: number, delivered: number[]): Promise<void>;
+    /**
+     * Record a successful wake for the cooldown.
+     *
+     * @param appId - App id
+     * @param recipient - Session or orchestrator key
+     * @param at - Epoch ms
+     */
+    setLastWake(appId: string, recipient: string, at: number): Promise<void>;
+    /**
+     * Store the visitor-wake cap state (P3 §3).
+     *
+     * @param appId - App id
+     * @param state - Day, wakes that day, submissions skipped and not yet reported
+     */
+    setVisitorWakes(appId: string, state: VisitorWakeState): Promise<void>;
+    /**
+     * Mark an app gone from Cloud.
+     *
+     * @param appId - App id
+     */
+    markDeleted(appId: string): Promise<void>;
+}
+//# sourceMappingURL=apps-registry.service.d.ts.map

package/dist/backend/backend/src/services/apps/apps-registry.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apps-registry.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/apps/apps-registry.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,uCAAuC;AACvC,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,uFAAuF;IACvF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,8DAA8D;IAC9D,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,gFAAgF;IAChF,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uHAAuH;IACvH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,gHAAgH;IAChH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,6GAA6G;IAC7G,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACjC;AAED,wDAAwD;AACxD,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,kGAAkG;IAClG,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,iDAAiD;AACjD,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,IAAI,CAA6B;IACzC,OAAO,CAAC,KAAK,CAAuC;IAEpD;;OAEG;gBACS,UAAU,EAAE,MAAM;YAIhB,IAAI;IAQlB,OAAO,CAAC,MAAM;IAYd;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAKzC;;;;;OAKG;IACG,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAM1D;;;;;;;OAOG;IACG,IAAI,CAAC,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAgB1D;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAwBjG;;;;;;;OAOG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAepF;;;;;;OAMG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9E;;;;;OAKG;IACG,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5E;;;;OAIG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAShD"}

package/dist/backend/backend/src/services/apps/apps-registry.service.js

@@ -0,0 +1,192 @@
+/**
+ * AppsRegistryService — the apps this instance published, kept in
+ * `<CREWLY_HOME>/apps/registry.json`.
+ *
+ * It answers two questions: which app an agent's publish goes to (so the
+ * same agent republishing the same directory lands on the same app), and
+ * which agent to wake when an app changes. It also keeps each app's change
+ * cursor for the poller (specs/2026-10-04-crewly-apps-p2.md §2, §5).
+ *
+ * @module services/apps/apps-registry.service
+ */
+import { promises as fs } from 'fs';
+import path from 'path';
+import { CREWLY_APPS_CONSTANTS } from '../../constants.js';
+import { atomicWriteJson, safeReadJson } from '../../utils/file-io.utils.js';
+/**
+ * File-backed registry. All writes are serialised in-process.
+ */
+export class AppsRegistryService {
+    file;
+    data = null;
+    chain = Promise.resolve();
+    /**
+     * @param crewlyHome - CREWLY_HOME directory
+     */
+    constructor(crewlyHome) {
+        this.file = path.join(crewlyHome, CREWLY_APPS_CONSTANTS.REGISTRY_DIR, CREWLY_APPS_CONSTANTS.REGISTRY_FILE);
+    }
+    async load() {
+        if (!this.data) {
+            const raw = await safeReadJson(this.file, { apps: {} });
+            this.data = raw && typeof raw === 'object' && raw.apps && typeof raw.apps === 'object' ? raw : { apps: {} };
+        }
+        return this.data;
+    }
+    mutate(fn) {
+        const run = this.chain.then(async () => {
+            const d = await this.load();
+            const out = fn(d);
+            await fs.mkdir(path.dirname(this.file), { recursive: true });
+            await atomicWriteJson(this.file, d);
+            return out;
+        });
+        this.chain = run.catch(() => undefined);
+        return run;
+    }
+    /**
+     * Every app, deleted ones included.
+     *
+     * @returns Copies of the entries
+     */
+    async list() {
+        const d = await this.load();
+        return Object.values(d.apps).map((e) => ({ ...e }));
+    }
+    /**
+     * One app by id.
+     *
+     * @param appId - App id
+     * @returns A copy, or null
+     */
+    async get(appId) {
+        const d = await this.load();
+        const e = d.apps[appId];
+        return e ? { ...e } : null;
+    }
+    /**
+     * The app a publish should go to: explicit id; else the same agent and
+     * source; else the same agent and name (case-insensitive). Deleted apps
+     * never match implicitly.
+     *
+     * @param q - Lookup keys
+     * @returns The entry, or null (create a new app)
+     */
+    async find(q) {
+        const d = await this.load();
+        if (q.appId)
+            return d.apps[q.appId] ? { ...d.apps[q.appId] } : null;
+        const mine = Object.values(d.apps).filter((e) => !e.deleted && (e.agentSession ?? null) === (q.agentSession ?? null));
+        if (q.source) {
+            const bySource = mine.find((e) => e.source === q.source);
+            if (bySource)
+                return { ...bySource };
+        }
+        if (q.name) {
+            const n = q.name.trim().toLowerCase();
+            const byName = mine.find((e) => e.name.trim().toLowerCase() === n);
+            if (byName)
+                return { ...byName };
+        }
+        return null;
+    }
+    /**
+     * Insert or update an entry (fields given replace the stored ones).
+     *
+     * @param appId - App id
+     * @param patch - Fields to set
+     * @returns The stored entry
+     */
+    upsert(appId, patch) {
+        return this.mutate((d) => {
+            const now = new Date().toISOString();
+            const prev = d.apps[appId];
+            const next = {
+                appId,
+                name: patch.name ?? prev?.name ?? appId,
+                url: patch.url ?? prev?.url ?? `${CREWLY_APPS_CONSTANTS.APPS_ORIGIN}/${appId}`,
+                agentSession: patch.agentSession !== undefined ? patch.agentSession : prev?.agentSession ?? null,
+                source: patch.source !== undefined ? patch.source : prev?.source ?? null,
+                currentVersion: patch.currentVersion !== undefined ? patch.currentVersion : prev?.currentVersion ?? null,
+                cursor: patch.cursor !== undefined ? patch.cursor : prev?.cursor ?? null,
+                createdAt: prev?.createdAt ?? now,
+                updatedAt: now,
+                ...(patch.deleted !== undefined ? { deleted: patch.deleted } : prev?.deleted ? { deleted: prev.deleted } : {}),
+                ...(prev?.wakes ? { wakes: prev.wakes } : {}),
+                ...(prev?.visitorWakes ? { visitorWakes: prev.visitorWakes } : {}),
+                ...(prev?.delivered && patch.cursor === undefined ? { delivered: prev.delivered } : {}),
+            };
+            d.apps[appId] = next;
+            return { ...next };
+        });
+    }
+    /**
+     * Store the poller's progress: the cursor and the seqs above it that were
+     * already delivered (no-op for an unknown app or no change).
+     *
+     * @param appId - App id
+     * @param cursor - Safe cursor (before every undelivered change)
+     * @param delivered - Delivered seqs above the cursor
+     */
+    async setProgress(appId, cursor, delivered) {
+        const current = (await this.load()).apps[appId];
+        if (!current)
+            return;
+        const sorted = [...delivered].filter((n) => n > cursor).sort((a, b) => a - b);
+        const same = current.cursor === cursor && JSON.stringify(current.delivered ?? []) === JSON.stringify(sorted);
+        if (same)
+            return;
+        await this.mutate((d) => {
+            const e = d.apps[appId];
+            if (!e)
+                return;
+            e.cursor = cursor;
+            if (sorted.length > 0)
+                e.delivered = sorted;
+            else
+                delete e.delivered;
+        });
+    }
+    /**
+     * Record a successful wake for the cooldown.
+     *
+     * @param appId - App id
+     * @param recipient - Session or orchestrator key
+     * @param at - Epoch ms
+     */
+    async setLastWake(appId, recipient, at) {
+        await this.mutate((d) => {
+            const e = d.apps[appId];
+            if (e)
+                e.wakes = { ...(e.wakes ?? {}), [recipient]: at };
+        });
+    }
+    /**
+     * Store the visitor-wake cap state (P3 §3).
+     *
+     * @param appId - App id
+     * @param state - Day, wakes that day, submissions skipped and not yet reported
+     */
+    async setVisitorWakes(appId, state) {
+        await this.mutate((d) => {
+            const e = d.apps[appId];
+            if (e)
+                e.visitorWakes = { day: state.day, count: state.count, skipped: state.skipped };
+        });
+    }
+    /**
+     * Mark an app gone from Cloud.
+     *
+     * @param appId - App id
+     */
+    async markDeleted(appId) {
+        await this.mutate((d) => {
+            const e = d.apps[appId];
+            if (e) {
+                e.deleted = true;
+                e.updatedAt = new Date().toISOString();
+            }
+        });
+    }
+}
+//# sourceMappingURL=apps-registry.service.js.map

package/dist/backend/backend/src/services/apps/apps-registry.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apps-registry.service.js","sourceRoot":"","sources":["../../../../../../backend/src/services/apps/apps-registry.service.ts"],"names":[],"mappings":"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"}