crewly 1.20.209 → 1.20.210

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

@@ -0,0 +1,383 @@
+/**
+ * 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 path from 'path';
+import { CREWLY_APPS_CONSTANTS } from '../../constants.js';
+import { AppsCloudError } from './apps-cloud.client.js';
+const C = CREWLY_APPS_CONSTANTS;
+const APP_ID_RE = /^[a-km-np-z2-9]{10}$/;
+const COLLECTION_RE = /^[A-Za-z0-9_-]{1,64}$/;
+const DOC_ID_RE = /^[A-Za-z0-9_.:-]{1,128}$/;
+function validation(message) {
+    return new AppsCloudError(400, C.ERROR_CODES.VALIDATION, message);
+}
+/**
+ * Check an app id's shape.
+ *
+ * @param appId - Candidate
+ * @returns The id
+ * @throws AppsCloudError validation
+ */
+export function requireAppId(appId) {
+    if (typeof appId !== 'string' || !APP_ID_RE.test(appId))
+        throw validation('appId must be a 10-character Crewly app id.');
+    return appId;
+}
+function requireCollection(c) {
+    if (typeof c !== 'string' || !COLLECTION_RE.test(c))
+        throw validation('collection must be 1-64 of A-Z a-z 0-9 _ -.');
+    return c;
+}
+function requireDocId(id) {
+    if (typeof id !== 'string' || !DOC_ID_RE.test(id) || id === '.' || id === '..') {
+        throw validation('docId must be 1-128 of A-Z a-z 0-9 _ . : - (and not "." or "..").');
+    }
+    return id;
+}
+function notYourApp() {
+    return new AppsCloudError(403, C.ERROR_CODES.NOT_YOUR_APP, 'This app was published by another agent. Only its publisher can publish or roll it back, and only the publisher and its team can use its data. Ask the owner if you need it.');
+}
+function requireData(data) {
+    if (!data || typeof data !== 'object' || Array.isArray(data))
+        throw validation('data must be a JSON object.');
+    return data;
+}
+function optString(v) {
+    return typeof v === 'string' && v.trim() ? v.trim() : undefined;
+}
+/**
+ * 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 function appCardText(name, appId) {
+    const clean = name.replace(/[[\]()\r\n]/g, ' ').replace(/\s+/g, ' ').trim() || 'App';
+    return `📱 ${clean} · [Open app](${C.APPS_ORIGIN}/${appId})`;
+}
+/**
+ * Publishing and data access for Crewly Apps.
+ */
+export class AppsService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /**
+     * 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
+     */
+    async publish(input, caller) {
+        const files = this.validateFiles(input.files);
+        const explicitId = input.appId !== undefined && input.appId !== null && input.appId !== '' ? requireAppId(input.appId) : undefined;
+        const source = optString(input.source) ?? null;
+        const name = optString(input.name);
+        const agentSession = caller.agentSession ?? null;
+        if (name && name.length > 80)
+            throw validation('name is at most 80 characters.');
+        const { registry, client } = this.deps;
+        let entry = await registry.find({ appId: explicitId, agentSession, source, name });
+        // An agent publishes only to its own apps; adopting an app made elsewhere is the owner's call.
+        if (explicitId && agentSession && (!entry || entry.agentSession !== agentSession))
+            throw notYourApp();
+        let app = null;
+        let created = false;
+        if (entry && !explicitId) {
+            // Found by source/name: if the owner deleted it, publish a new app instead.
+            try {
+                app = await client.request('GET', `/apps/${entry.appId}`, { agent: caller.agentSession });
+            }
+            catch (err) {
+                if (!(err instanceof AppsCloudError) || err.status !== 404)
+                    throw err;
+                await registry.markDeleted(entry.appId);
+                entry = null;
+            }
+        }
+        else if (entry) {
+            app = await client.request('GET', `/apps/${entry.appId}`, { agent: caller.agentSession });
+        }
+        if (entry && app) {
+            if (name && name !== app.name) {
+                app = await client.request('PATCH', `/apps/${app.appId}`, { body: { name }, agent: caller.agentSession });
+            }
+        }
+        else if (explicitId) {
+            // An app made elsewhere (another machine, the portal): adopt it.
+            app = await client.request('GET', `/apps/${explicitId}`, { agent: caller.agentSession });
+        }
+        else {
+            const newName = name ?? (source ? path.basename(source).replace(/\.[^.]+$/, '') : '');
+            app = await client.request('POST', '/apps', { body: { name: newName.slice(0, 80) || 'App' }, agent: caller.agentSession });
+            created = true;
+        }
+        const entryFile = optString(input.entry);
+        const note = optString(input.note);
+        const version = await client.request('POST', `/apps/${app.appId}/versions`, {
+            body: {
+                files,
+                ...(entryFile ? { entry: entryFile } : {}),
+                ...(note ? { note: note.slice(0, 200) } : {}),
+            },
+            agent: caller.agentSession,
+        });
+        entry = await registry.upsert(app.appId, {
+            name: app.name,
+            url: app.url,
+            // The last agent to publish owns the wake; an owner publish keeps it.
+            ...(agentSession ? { agentSession } : {}),
+            ...(source ? { source } : {}),
+            currentVersion: version.version,
+            // A brand-new app has no history: start right before its first change,
+            // so an owner edit made before the first poll is not skipped.
+            ...(created ? { cursor: 0 } : {}),
+            deleted: false,
+        });
+        let notified = false;
+        let notifyError;
+        if (input.notify === true) {
+            if (!caller.agentSession) {
+                notifyError = 'Only an agent can post the app card (it goes out under the agent’s identity).';
+            }
+            else if (!this.deps.notifyCard) {
+                notifyError = 'Posting the app card is not available on this instance.';
+            }
+            else {
+                const r = await this.deps.notifyCard(caller.agentSession, appCardText(app.name, app.appId)).catch((err) => ({
+                    ok: false,
+                    error: err instanceof Error ? err.message : String(err),
+                }));
+                notified = r.ok;
+                if (!r.ok)
+                    notifyError = r.error ?? 'The card could not be delivered.';
+            }
+        }
+        return {
+            appId: app.appId,
+            name: app.name,
+            url: `${C.APPS_ORIGIN}/${app.appId}`,
+            version: version.version,
+            created,
+            notified,
+            ...(notifyError ? { notifyError } : {}),
+        };
+    }
+    /**
+     * Make an earlier retained version current.
+     *
+     * @param appId - App id
+     * @param version - Version number
+     * @param caller - Agent or owner
+     * @returns The app after rollback
+     */
+    async rollback(appId, version, caller) {
+        const id = requireAppId(appId);
+        const v = typeof version === 'string' ? Number(version) : version;
+        if (typeof v !== 'number' || !Number.isInteger(v) || v < 1)
+            throw validation('version must be a positive integer.');
+        await this.assertPublisher(id, caller);
+        const app = await this.deps.client.request('POST', `/apps/${id}/rollback`, { body: { version: v }, agent: caller.agentSession });
+        if (await this.deps.registry.get(id))
+            await this.deps.registry.upsert(id, { currentVersion: app.currentVersion });
+        return app;
+    }
+    /**
+     * Versions of an app, newest first.
+     *
+     * @param appId - App id
+     * @param caller - Agent or owner
+     * @returns Versions
+     */
+    async versions(appId, caller) {
+        const id = requireAppId(appId);
+        await this.assertPublisher(id, caller);
+        return this.deps.client.request('GET', `/apps/${id}/versions`, { agent: caller.agentSession });
+    }
+    /**
+     * 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
+     */
+    async assertPublisher(appId, caller) {
+        if (!caller.agentSession)
+            return;
+        const entry = await this.deps.registry.get(appId);
+        if (!entry || entry.agentSession !== caller.agentSession)
+            throw notYourApp();
+    }
+    /**
+     * 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
+     */
+    async assertDataAccess(appId, caller) {
+        const me = caller.agentSession;
+        if (!me)
+            return;
+        const entry = await this.deps.registry.get(appId);
+        const publisher = entry?.agentSession;
+        if (!publisher)
+            throw notYourApp();
+        if (publisher === me)
+            return;
+        if (this.deps.sameTeam && (await this.deps.sameTeam(me, publisher).catch(() => false)))
+            return;
+        throw notYourApp();
+    }
+    /**
+     * Apps this instance published (local registry, not Cloud).
+     *
+     * @returns Entries without the poller cursor
+     */
+    async list(caller = {}) {
+        return (await this.deps.registry.list())
+            .filter((e) => !caller.agentSession || e.agentSession === caller.agentSession)
+            .map(({ cursor: _cursor, delivered: _delivered, wakes: _wakes, ...rest }) => rest);
+    }
+    /**
+     * One page of a collection.
+     *
+     * @param appId - App id
+     * @param collection - Collection
+     * @param opts - limit / after
+     * @param caller - Agent or owner
+     * @returns `{ docs, next }`
+     */
+    async listDocs(appId, collection, opts, caller) {
+        const limit = opts.limit !== undefined && opts.limit !== '' ? Number(opts.limit) : undefined;
+        if (limit !== undefined && (!Number.isInteger(limit) || limit < 1 || limit > 500))
+            throw validation('limit is 1-500.');
+        const after = opts.after !== undefined && opts.after !== '' ? requireDocId(opts.after) : undefined;
+        const path = `/apps/${requireAppId(appId)}/data/${requireCollection(collection)}`;
+        await this.assertDataAccess(appId, caller);
+        return this.deps.client.request('GET', path, {
+            query: { limit, after },
+            agent: caller.agentSession,
+        });
+    }
+    /**
+     * 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
+     */
+    async getDoc(appId, collection, docId, caller) {
+        const path = this.docPath(appId, collection, docId);
+        await this.assertDataAccess(appId, caller);
+        return this.deps.client.request('GET', path, { agent: caller.agentSession });
+    }
+    /**
+     * 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
+     */
+    async setDoc(appId, collection, docId, data, caller) {
+        const path = this.docPath(appId, collection, docId);
+        const body = { data: requireData(data) };
+        await this.assertDataAccess(appId, caller);
+        return this.deps.client.request('PUT', path, { body, agent: caller.agentSession });
+    }
+    /**
+     * 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
+     */
+    async updateDoc(appId, collection, docId, data, ifRev, caller) {
+        const rev = ifRev === undefined || ifRev === null || ifRev === '' ? undefined : Number(ifRev);
+        if (rev !== undefined && (!Number.isInteger(rev) || rev < 0))
+            throw validation('ifRev must be a non-negative integer.');
+        const path = this.docPath(appId, collection, docId);
+        const body = { data: requireData(data), ...(rev !== undefined ? { ifRev: rev } : {}) };
+        await this.assertDataAccess(appId, caller);
+        return this.deps.client.request('PATCH', path, {
+            body,
+            agent: caller.agentSession,
+        });
+    }
+    /**
+     * 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
+     */
+    async addDoc(appId, collection, data, caller) {
+        const path = `/apps/${requireAppId(appId)}/data/${requireCollection(collection)}`;
+        const body = { data: requireData(data) };
+        await this.assertDataAccess(appId, caller);
+        return this.deps.client.request('POST', path, {
+            body,
+            agent: caller.agentSession,
+        });
+    }
+    /**
+     * Delete a document.
+     *
+     * @param appId - App id
+     * @param collection - Collection
+     * @param docId - Document id
+     * @param caller - Agent or owner
+     * @returns `{ deleted: true }`
+     */
+    async deleteDoc(appId, collection, docId, caller) {
+        const path = this.docPath(appId, collection, docId);
+        await this.assertDataAccess(appId, caller);
+        return this.deps.client.request('DELETE', path, { agent: caller.agentSession });
+    }
+    docPath(appId, collection, docId) {
+        return `/apps/${requireAppId(appId)}/data/${requireCollection(collection)}/${encodeURIComponent(requireDocId(docId))}`;
+    }
+    validateFiles(files) {
+        if (!Array.isArray(files) || files.length === 0)
+            throw validation('files must be a non-empty array of { path, contentBase64 }.');
+        return files.map((f, i) => {
+            const o = (f ?? {});
+            if (typeof o.path !== 'string' || !o.path || o.path.startsWith('/') || o.path.split('/').includes('..')) {
+                throw validation(`files[${i}].path must be a relative path inside the bundle.`);
+            }
+            if (typeof o.contentBase64 !== 'string')
+                throw validation(`files[${i}].contentBase64 is required.`);
+            return {
+                path: o.path,
+                contentBase64: o.contentBase64,
+                ...(typeof o.contentType === 'string' && o.contentType ? { contentType: o.contentType } : {}),
+            };
+        });
+    }
+}
+//# sourceMappingURL=apps.service.js.map

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

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

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

@@ -0,0 +1,83 @@
+/**
+ * Crewly Apps wiring: the shared registry / Cloud client / service the
+ * `/api/apps` controller uses, and the change poller started at boot
+ * (specs/2026-10-04-crewly-apps-p2.md).
+ *
+ * @module services/apps/apps.wiring
+ */
+import { AppsCloudClient } from './apps-cloud.client.js';
+import { AppsRegistryService } from './apps-registry.service.js';
+import { AppsService } from './apps.service.js';
+import { AppWakeService } from './app-wake.service.js';
+/** The team shape the apps code reads. */
+export interface AppsTeam {
+    members?: Array<{
+        sessionName?: string;
+        name?: string;
+    }>;
+}
+/** Where teams come from. */
+export type AppsTeamsSource = () => Promise<AppsTeam[]>;
+interface AppsParts {
+    client: AppsCloudClient;
+    registry: AppsRegistryService;
+    service: AppsService;
+}
+/**
+ * This instance's Cloud device id (what `X-Crewly-Instance` names).
+ *
+ * @returns The id, or null before the Slack instance registry resolved it
+ */
+export declare function currentInstanceId(): Promise<string | null>;
+/**
+ * Whether two sessions are members of the same team.
+ *
+ * @param teams - Teams source
+ * @returns Predicate
+ */
+export declare function sameTeamFrom(teams: AppsTeamsSource): (a: string, b: string) => Promise<boolean>;
+/**
+ * Resolve an `ask` target name to a session — only inside the publisher's
+ * own team (by session or display name, case-insensitive).
+ *
+ * @param teams - Teams source
+ * @returns Resolver
+ */
+export declare function teamAgentResolver(teams: AppsTeamsSource): (name: string, publisher: string) => Promise<string | null>;
+/**
+ * The shared Apps parts, built on first use.
+ *
+ * @param teams - Teams source (default: the storage service)
+ * @returns Client, registry and service
+ */
+export declare function getAppsParts(teams?: AppsTeamsSource): AppsParts;
+/**
+ * Replace the shared parts (tests), or null to rebuild lazily.
+ *
+ * @param next - Parts or null
+ */
+export declare function setAppsParts(next: AppsParts | null): void;
+/** Inputs of {@link startAppWake}. */
+export interface StartAppWakeInput {
+    /** Agent skills root (`config/skills/agent`) */
+    skillsPath: string;
+    /** Wake an agent with a message; `activate` = start it first when it is down */
+    sendToAgent: (session: string, text: string, activate: boolean) => Promise<boolean>;
+    /** Hand a message to the orchestrator */
+    sendToOrchestrator: (text: string) => Promise<boolean>;
+    /** Whether an agent's session is running */
+    sessionExists: (session: string) => boolean;
+    /** Teams on this instance */
+    getTeams: AppsTeamsSource;
+}
+/**
+ * Start the app change poller (idempotent).
+ *
+ * @param input - Delivery callbacks and paths
+ * @returns The running service
+ */
+export declare function startAppWake(input: StartAppWakeInput): AppWakeService;
+/** Stop the poller (shutdown; tests). */
+export declare function stopAppWake(): void;
+export {};
+//# sourceMappingURL=apps.wiring.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apps.wiring.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/apps/apps.wiring.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,WAAW,EAAwB,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,0CAA0C;AAC1C,MAAM,WAAW,QAAQ;IACvB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1D;AAED,6BAA6B;AAC7B,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;AAExD,UAAU,SAAS;IACjB,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,OAAO,EAAE,WAAW,CAAC;CACtB;AAWD;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAIhE;AAaD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAK/F;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWrH;AAYD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,GAAE,eAA8B,GAAG,SAAS,CAO7E;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI,CAEzD;AAED,sCAAsC;AACtC,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACpF,yCAAyC;IACzC,kBAAkB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD,4CAA4C;IAC5C,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IAC5C,6BAA6B;IAC7B,QAAQ,EAAE,eAAe,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,cAAc,CAarE;AAED,yCAAyC;AACzC,wBAAgB,WAAW,IAAI,IAAI,CAGlC"}

package/dist/backend/backend/src/services/apps/apps.wiring.js

@@ -0,0 +1,133 @@
+/**
+ * Crewly Apps wiring: the shared registry / Cloud client / service the
+ * `/api/apps` controller uses, and the change poller started at boot
+ * (specs/2026-10-04-crewly-apps-p2.md).
+ *
+ * @module services/apps/apps.wiring
+ */
+import { getCrewlyHomePath } from '../core/crewly-home.utils.js';
+import { getSlackInstanceRegistryService } from '../slack/slack-instance-registry.service.js';
+import { AppsCloudClient } from './apps-cloud.client.js';
+import { AppsRegistryService } from './apps-registry.service.js';
+import { AppsService } from './apps.service.js';
+import { AppWakeService } from './app-wake.service.js';
+let parts = null;
+let wake = null;
+/** Default teams source: the storage service, loaded lazily. */
+const defaultTeams = async () => {
+    const { StorageService } = await import('../core/storage.service.js');
+    return StorageService.getInstance().getTeams();
+};
+/**
+ * This instance's Cloud device id (what `X-Crewly-Instance` names).
+ *
+ * @returns The id, or null before the Slack instance registry resolved it
+ */
+export async function currentInstanceId() {
+    const registry = getSlackInstanceRegistryService();
+    if (!registry)
+        return null;
+    return registry.getInstanceId() ?? (await registry.resolveInstanceId());
+}
+/**
+ * The team that has this session as a member.
+ *
+ * @param teams - Teams
+ * @param session - Agent session
+ * @returns The team, or undefined
+ */
+function teamOf(teams, session) {
+    return teams.find((t) => (t.members ?? []).some((m) => m.sessionName === session));
+}
+/**
+ * Whether two sessions are members of the same team.
+ *
+ * @param teams - Teams source
+ * @returns Predicate
+ */
+export function sameTeamFrom(teams) {
+    return async (a, b) => {
+        const team = teamOf(await teams(), a);
+        return !!team && (team.members ?? []).some((m) => m.sessionName === b);
+    };
+}
+/**
+ * Resolve an `ask` target name to a session — only inside the publisher's
+ * own team (by session or display name, case-insensitive).
+ *
+ * @param teams - Teams source
+ * @returns Resolver
+ */
+export function teamAgentResolver(teams) {
+    return async (name, publisher) => {
+        const team = teamOf(await teams(), publisher);
+        if (!team)
+            return null;
+        const wanted = name.trim().toLowerCase();
+        for (const m of team.members ?? []) {
+            if (!m.sessionName)
+                continue;
+            if (m.sessionName.toLowerCase() === wanted || (m.name ?? '').trim().toLowerCase() === wanted)
+                return m.sessionName;
+        }
+        return null;
+    };
+}
+/**
+ * Post the app card where the agent talks with the owner, through the same
+ * resolver `reply` uses.
+ */
+const defaultNotifyCard = async (agentSession, text) => {
+    const { deliverReply } = await import('../orc/reply-destination.wiring.js');
+    const r = await deliverReply({ session: agentSession, content: text, addsNew: true });
+    return r.ok ? { ok: true } : { ok: false, error: r.error };
+};
+/**
+ * The shared Apps parts, built on first use.
+ *
+ * @param teams - Teams source (default: the storage service)
+ * @returns Client, registry and service
+ */
+export function getAppsParts(teams = defaultTeams) {
+    if (!parts) {
+        const client = new AppsCloudClient({ instanceId: currentInstanceId });
+        const registry = new AppsRegistryService(getCrewlyHomePath());
+        parts = { client, registry, service: new AppsService({ client, registry, notifyCard: defaultNotifyCard, sameTeam: sameTeamFrom(teams) }) };
+    }
+    return parts;
+}
+/**
+ * Replace the shared parts (tests), or null to rebuild lazily.
+ *
+ * @param next - Parts or null
+ */
+export function setAppsParts(next) {
+    parts = next;
+}
+/**
+ * Start the app change poller (idempotent).
+ *
+ * @param input - Delivery callbacks and paths
+ * @returns The running service
+ */
+export function startAppWake(input) {
+    if (wake)
+        return wake;
+    const { client, registry } = getAppsParts(input.getTeams);
+    wake = new AppWakeService({
+        client,
+        registry,
+        skillsPath: input.skillsPath,
+        deliver: (session, text, opts) => (session ? input.sendToAgent(session, text, opts.activate) : input.sendToOrchestrator(text)),
+        resolveAgent: teamAgentResolver(input.getTeams),
+        isRunning: input.sessionExists,
+    });
+    wake.start();
+    return wake;
+}
+/** Stop the poller (shutdown; tests). */
+export function stopAppWake() {
+    wake?.stop();
+    wake = null;
+}
+//# sourceMappingURL=apps.wiring.js.map

package/dist/backend/backend/src/services/apps/apps.wiring.js.map

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

package/dist/backend/build-info.json

@@ -1,4 +1,4 @@
 {
-  "commit": "5693fbb61016f2c5d2202310e10a8ad1319a7a02",
-  "builtAt": "2026-10-04T12:54:51.246Z"
+  "commit": "5c77668fe72f598fee8e54c1b1ec144c7d9975af",
+  "builtAt": "2026-10-04T14:00:16.980Z"
 }