crewly 1.20.209 → 1.20.210

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;CACtB;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;IAuBjG;;;;;;;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;;;;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,178 @@
+/**
+ * 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?.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 };
+        });
+    }
+    /**
+     * 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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"}

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

@@ -0,0 +1,217 @@
+/**
+ * AppsService — publish, roll back and read/write the data of Crewly Apps
+ * on behalf of an agent (or the owner), through {@link AppsCloudClient}.
+ *
+ * Backs `/api/apps` and the publish-app / app-data skills
+ * (specs/2026-10-04-crewly-apps-p2.md).
+ *
+ * @module services/apps/apps.service
+ */
+import { AppsCloudClient } from './apps-cloud.client.js';
+import type { AppRegistryEntry, AppsRegistryService } from './apps-registry.service.js';
+/** Cloud's view of an app (apps/SPEC.md §3.1). */
+export interface CloudAppView {
+    appId: string;
+    name: string;
+    slug: string | null;
+    url: string;
+    currentVersion: number | null;
+    latestVersion: number;
+}
+/** Cloud's view of a version. */
+export interface CloudVersionView {
+    version: number;
+    entry: string;
+    files: number;
+    totalBytes: number;
+    note: string | null;
+    createdAt: string;
+    current: boolean;
+}
+/** One bundle file as the skill sends it. */
+export interface PublishFile {
+    path: string;
+    contentBase64: string;
+    contentType?: string;
+}
+/** Input of {@link AppsService.publish}. */
+export interface PublishInput {
+    files: unknown;
+    name?: unknown;
+    appId?: unknown;
+    source?: unknown;
+    entry?: unknown;
+    note?: unknown;
+    notify?: unknown;
+}
+/** Result of a publish. */
+export interface PublishResult {
+    appId: string;
+    name: string;
+    url: string;
+    version: number;
+    created: boolean;
+    notified: boolean;
+    notifyError?: string;
+}
+/** Who is calling: an agent session, or the owner (no session). */
+export interface AppsCaller {
+    agentSession?: string;
+}
+/** Posts the "Open app" card where the agent talks with the owner. */
+export type AppCardNotifier = (agentSession: string, text: string) => Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+/** Constructor dependencies. */
+export interface AppsServiceDeps {
+    client: AppsCloudClient;
+    registry: AppsRegistryService;
+    notifyCard?: AppCardNotifier;
+    /** Whether two agent sessions are in the same team (data access for the publisher's team) */
+    sameTeam?: (a: string, b: string) => Promise<boolean>;
+}
+/**
+ * Check an app id's shape.
+ *
+ * @param appId - Candidate
+ * @returns The id
+ * @throws AppsCloudError validation
+ */
+export declare function requireAppId(appId: unknown): string;
+/**
+ * The "📱 <name> · Open app" card text. Markdown link: the reply path turns
+ * it into a Slack link.
+ *
+ * @param name - App name
+ * @param appId - App id
+ * @returns Card text
+ */
+export declare function appCardText(name: string, appId: string): string;
+/**
+ * Publishing and data access for Crewly Apps.
+ */
+export declare class AppsService {
+    private readonly deps;
+    constructor(deps: AppsServiceDeps);
+    /**
+     * Publish a bundle: find the caller's app (or create one), upload a new
+     * version, record it locally, and optionally post the Slack card.
+     *
+     * @param input - Files and options from the skill
+     * @param caller - Agent session or owner
+     * @returns appId, url, version, whether it was created / notified
+     * @throws AppsCloudError on validation or a Cloud failure
+     */
+    publish(input: PublishInput, caller: AppsCaller): Promise<PublishResult>;
+    /**
+     * Make an earlier retained version current.
+     *
+     * @param appId - App id
+     * @param version - Version number
+     * @param caller - Agent or owner
+     * @returns The app after rollback
+     */
+    rollback(appId: unknown, version: unknown, caller: AppsCaller): Promise<CloudAppView>;
+    /**
+     * Versions of an app, newest first.
+     *
+     * @param appId - App id
+     * @param caller - Agent or owner
+     * @returns Versions
+     */
+    versions(appId: unknown, caller: AppsCaller): Promise<CloudVersionView[]>;
+    /**
+     * Agents may manage (publish, roll back, list versions of) only apps they
+     * published. The owner may manage any.
+     *
+     * @param appId - App id
+     * @param caller - Agent or owner
+     * @throws AppsCloudError 403 not_your_app
+     */
+    assertPublisher(appId: string, caller: AppsCaller): Promise<void>;
+    /**
+     * Agents may read and write the data of apps they published, or that a
+     * teammate published. The owner may use any.
+     *
+     * @param appId - App id
+     * @param caller - Agent or owner
+     * @throws AppsCloudError 403 not_your_app
+     */
+    assertDataAccess(appId: string, caller: AppsCaller): Promise<void>;
+    /**
+     * Apps this instance published (local registry, not Cloud).
+     *
+     * @returns Entries without the poller cursor
+     */
+    list(caller?: AppsCaller): Promise<Array<Omit<AppRegistryEntry, 'cursor' | 'delivered' | 'wakes'>>>;
+    /**
+     * One page of a collection.
+     *
+     * @param appId - App id
+     * @param collection - Collection
+     * @param opts - limit / after
+     * @param caller - Agent or owner
+     * @returns `{ docs, next }`
+     */
+    listDocs(appId: unknown, collection: unknown, opts: {
+        limit?: unknown;
+        after?: unknown;
+    }, caller: AppsCaller): Promise<unknown>;
+    /**
+     * One document (`{ id, data, rev, … }`); a missing one throws 404 not_found.
+     *
+     * @param appId - App id
+     * @param collection - Collection
+     * @param docId - Document id
+     * @param caller - Agent or owner
+     * @returns The document
+     */
+    getDoc(appId: unknown, collection: unknown, docId: unknown, caller: AppsCaller): Promise<unknown>;
+    /**
+     * Replace (or create) a document.
+     *
+     * @param appId - App id
+     * @param collection - Collection
+     * @param docId - Document id
+     * @param data - New content
+     * @param caller - Agent or owner
+     * @returns The stored document
+     */
+    setDoc(appId: unknown, collection: unknown, docId: unknown, data: unknown, caller: AppsCaller): Promise<unknown>;
+    /**
+     * Shallow-merge into a document; `ifRev` makes it conditional (409 conflict).
+     *
+     * @param appId - App id
+     * @param collection - Collection
+     * @param docId - Document id
+     * @param data - Fields to merge
+     * @param ifRev - Expected current rev (optional)
+     * @param caller - Agent or owner
+     * @returns The stored document
+     */
+    updateDoc(appId: unknown, collection: unknown, docId: unknown, data: unknown, ifRev: unknown, caller: AppsCaller): Promise<unknown>;
+    /**
+     * Add a document with a generated id.
+     *
+     * @param appId - App id
+     * @param collection - Collection
+     * @param data - Content
+     * @param caller - Agent or owner
+     * @returns The stored document
+     */
+    addDoc(appId: unknown, collection: unknown, data: unknown, caller: AppsCaller): Promise<unknown>;
+    /**
+     * Delete a document.
+     *
+     * @param appId - App id
+     * @param collection - Collection
+     * @param docId - Document id
+     * @param caller - Agent or owner
+     * @returns `{ deleted: true }`
+     */
+    deleteDoc(appId: unknown, collection: unknown, docId: unknown, caller: AppsCaller): Promise<unknown>;
+    private docPath;
+    private validateFiles;
+}
+//# sourceMappingURL=apps.service.d.ts.map

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

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