crewly 1.20.133 → 1.20.134

package/dist/cli/backend/src/services/bundle/bundle-skill-installer.js

@@ -0,0 +1,144 @@
+/**
+ * Skill installation for bundles, through the existing marketplace install.
+ *
+ * Kept behind {@link BundleSkillInstaller} so the apply engine can switch to
+ * the skill-autoinstall runner (`feat/skill-autoinstall`: skill discovery
+ * over bundled / installed / registry skills + install jobs with setup
+ * recipes) when it lands, without touching the engine.
+ *
+ * A skill counts as available when it is bundled with Crewly
+ * (`config/skills/{agent,team-leader,orchestrator}/**`) or already installed
+ * from the marketplace. Missing ones are installed with the marketplace
+ * installer (`POST /api/marketplace/:id/install` / `crewly install <id>`).
+ *
+ * @module services/bundle/bundle-skill-installer
+ */
+import { existsSync, readdirSync, statSync } from 'fs';
+import * as path from 'path';
+/** Skill roots under `config/skills/` that ship with Crewly. */
+const BUNDLED_SKILL_ROOTS = ['agent', 'team-leader', 'orchestrator'];
+/** How deep a skill folder may sit under a root (e.g. agent/core/<id>). */
+const MAX_SKILL_DEPTH = 3;
+/** Files that make a folder a skill. */
+const SKILL_MARKERS = ['SKILL.md', 'skill.json', 'execute.sh'];
+/**
+ * Find a skill folder by id under the bundled skill roots.
+ *
+ * @param packageRoot - Crewly package root (contains `config/skills`)
+ * @param skillId - Skill id (folder name)
+ * @returns The folder, or null
+ */
+export function findBundledSkill(packageRoot, skillId) {
+    const walk = (dir, depth) => {
+        let entries;
+        try {
+            entries = readdirSync(dir);
+        }
+        catch {
+            return null;
+        }
+        for (const entry of entries) {
+            if (entry.startsWith('.') || entry.startsWith('_'))
+                continue;
+            const full = path.join(dir, entry);
+            try {
+                if (!statSync(full).isDirectory())
+                    continue;
+            }
+            catch {
+                continue;
+            }
+            if (entry === skillId && SKILL_MARKERS.some((m) => existsSync(path.join(full, m))))
+                return full;
+            if (depth < MAX_SKILL_DEPTH) {
+                const found = walk(full, depth + 1);
+                if (found)
+                    return found;
+            }
+        }
+        return null;
+    };
+    for (const root of BUNDLED_SKILL_ROOTS) {
+        const found = walk(path.join(packageRoot, 'config', 'skills', root), 1);
+        if (found)
+            return found;
+    }
+    return null;
+}
+/**
+ * A {@link BundleSkillInstaller} over the marketplace.
+ *
+ * @param deps - Package root, homes and marketplace functions
+ * @returns Installer
+ */
+export function createMarketplaceSkillInstaller(deps) {
+    return {
+        async isAvailable(skillId) {
+            if (findBundledSkill(deps.packageRoot, skillId))
+                return true;
+            try {
+                return existsSync(deps.installPath(skillId));
+            }
+            catch {
+                return false;
+            }
+        },
+        async install(skillId) {
+            if (path.resolve(deps.crewlyHome) !== path.resolve(deps.marketplaceHome)) {
+                return {
+                    ok: false,
+                    message: `Not installed: the marketplace installs into ${deps.marketplaceHome}, not this CREWLY_HOME (${deps.crewlyHome})`,
+                };
+            }
+            const registry = await deps.fetchRegistry();
+            const item = registry.items.find((i) => i.id === skillId && i.type === 'skill');
+            if (!item)
+                return { ok: false, message: `"${skillId}" is not in the marketplace` };
+            const result = await deps.installItem(item);
+            return { ok: result.success, message: result.message };
+        },
+    };
+}
+/**
+ * Bundle skill installer on the skill-setup services (specs/skill-auto-install.md):
+ * a skill counts as available only when its declared dependencies are set up,
+ * and installing runs that setup too (brew/apt/model downloads). Deploying a
+ * bundle is the owner's own action, so third-party skills in it install as
+ * the owner (`ownerDashboard`).
+ *
+ * @param deps - Discovery and install-job services
+ * @returns Installer for the apply engine
+ */
+export function createSkillSetupInstaller(deps) {
+    return {
+        async isAvailable(skillId) {
+            const skill = await deps.discovery.resolve(skillId);
+            if (!skill || !skill.installed)
+                return false;
+            const probed = await deps.discovery.probe(skill);
+            return probed.ready !== false;
+        },
+        async install(skillId) {
+            const skill = await deps.discovery.resolve(skillId);
+            if (!skill)
+                return { ok: false, message: `"${skillId}" is not bundled with Crewly or listed in the marketplace` };
+            // A download from the marketplace lands in ~/.crewly whatever CREWLY_HOME
+            // says — refuse rather than write into the real home from a test deploy.
+            if (!skill.installed && path.resolve(deps.crewlyHome) !== path.resolve(deps.marketplaceHome)) {
+                return {
+                    ok: false,
+                    message: `Not installed: the marketplace installs into ${deps.marketplaceHome}, not this CREWLY_HOME (${deps.crewlyHome})`,
+                };
+            }
+            const started = await deps.jobs.startInstall({ skillId, ownerDashboard: true, resumeNote: 'solution bundle deploy' });
+            if (started.kind === 'already-ready')
+                return { ok: true, message: `${skillId} already set up` };
+            const job = await deps.jobs.waitForJob(started.job.jobId);
+            const tail = job.log.trim().split('\n').slice(-3).join(' | ');
+            return job.state === 'succeeded'
+                ? { ok: true, message: `${skillId} installed and set up` }
+                : { ok: false, message: `${skillId} install failed${tail ? `: ${tail}` : ''}` };
+        },
+    };
+}
+//# sourceMappingURL=bundle-skill-installer.js.map

package/dist/cli/backend/src/services/bundle/bundle-skill-installer.js.map

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

package/dist/cli/backend/src/services/bundle/bundle-state.store.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Bundle deployment store — `<crewlyHome>/bundles/<templateId>.json`.
+ *
+ * One file per deployed template. The apply engine writes it after every
+ * step, so a crash or a failed step leaves an accurate record and a re-run
+ * resumes from it. Writes are atomic (temp file + rename).
+ *
+ * @module services/bundle/bundle-state.store
+ */
+import type { BundleDeployment } from '../../types/solution-bundle.types.js';
+/**
+ * Persists bundle deployments.
+ */
+export declare class BundleDeploymentStore {
+    private readonly dir;
+    /**
+     * @param crewlyHome - Crewly home directory
+     */
+    constructor(crewlyHome: string);
+    /**
+     * File of a template's deployment.
+     *
+     * @param templateId - Template id (kebab case)
+     * @returns Absolute path
+     * @throws Error for an id that is not a safe file name
+     */
+    fileFor(templateId: string): string;
+    /**
+     * Read a deployment.
+     *
+     * @param templateId - Template id
+     * @returns The deployment, or null when the template was never deployed (or the file is unreadable)
+     */
+    read(templateId: string): Promise<BundleDeployment | null>;
+    /**
+     * Write a deployment atomically.
+     *
+     * @param deployment - Deployment
+     */
+    write(deployment: BundleDeployment): Promise<void>;
+    /**
+     * Every stored deployment.
+     *
+     * @returns Deployments (unreadable files are skipped)
+     */
+    list(): Promise<BundleDeployment[]>;
+}
+//# sourceMappingURL=bundle-state.store.d.ts.map

package/dist/cli/backend/src/services/bundle/bundle-state.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-state.store.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/bundle/bundle-state.store.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAM7E;;GAEG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAE7B;;OAEG;gBACS,UAAU,EAAE,MAAM;IAI9B;;;;;;OAMG;IACH,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAKnC;;;;;OAKG;IACG,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAShE;;;;OAIG;IACG,KAAK,CAAC,UAAU,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxD;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAiB1C"}

package/dist/cli/backend/src/services/bundle/bundle-state.store.js

@@ -0,0 +1,90 @@
+/**
+ * Bundle deployment store — `<crewlyHome>/bundles/<templateId>.json`.
+ *
+ * One file per deployed template. The apply engine writes it after every
+ * step, so a crash or a failed step leaves an accurate record and a re-run
+ * resumes from it. Writes are atomic (temp file + rename).
+ *
+ * @module services/bundle/bundle-state.store
+ */
+import { promises as fs } from 'fs';
+import * as path from 'path';
+import { BUNDLE_CONSTANTS } from '../../constants.js';
+import { atomicWriteFile } from '../../utils/file-io.utils.js';
+/** Template ids become file names; keep them to safe characters. */
+const SAFE_ID_PATTERN = /^[a-z0-9][a-z0-9-]*$/;
+/**
+ * Persists bundle deployments.
+ */
+export class BundleDeploymentStore {
+    dir;
+    /**
+     * @param crewlyHome - Crewly home directory
+     */
+    constructor(crewlyHome) {
+        this.dir = path.join(crewlyHome, BUNDLE_CONSTANTS.STATE_DIR);
+    }
+    /**
+     * File of a template's deployment.
+     *
+     * @param templateId - Template id (kebab case)
+     * @returns Absolute path
+     * @throws Error for an id that is not a safe file name
+     */
+    fileFor(templateId) {
+        if (!SAFE_ID_PATTERN.test(templateId))
+            throw new Error(`Invalid template id: ${templateId}`);
+        return path.join(this.dir, `${templateId}.json`);
+    }
+    /**
+     * Read a deployment.
+     *
+     * @param templateId - Template id
+     * @returns The deployment, or null when the template was never deployed (or the file is unreadable)
+     */
+    async read(templateId) {
+        try {
+            const parsed = JSON.parse(await fs.readFile(this.fileFor(templateId), 'utf-8'));
+            return parsed && parsed.templateId === templateId && Array.isArray(parsed.steps) ? parsed : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Write a deployment atomically.
+     *
+     * @param deployment - Deployment
+     */
+    async write(deployment) {
+        await fs.mkdir(this.dir, { recursive: true });
+        await atomicWriteFile(this.fileFor(deployment.templateId), JSON.stringify(deployment, null, 2));
+    }
+    /**
+     * Every stored deployment.
+     *
+     * @returns Deployments (unreadable files are skipped)
+     */
+    async list() {
+        let entries;
+        try {
+            entries = await fs.readdir(this.dir);
+        }
+        catch {
+            return [];
+        }
+        const out = [];
+        for (const entry of entries.sort()) {
+            if (!entry.endsWith('.json'))
+                continue;
+            const id = entry.slice(0, -'.json'.length);
+            if (!SAFE_ID_PATTERN.test(id))
+                continue;
+            const deployment = await this.read(id);
+            if (deployment)
+                out.push(deployment);
+        }
+        return out;
+    }
+}
+//# sourceMappingURL=bundle-state.store.js.map

package/dist/cli/backend/src/services/bundle/bundle-state.store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-state.store.js","sourceRoot":"","sources":["../../../../../../backend/src/services/bundle/bundle-state.store.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,oEAAoE;AACpE,MAAM,eAAe,GAAG,sBAAsB,CAAC;AAE/C;;GAEG;AACH,MAAM,OAAO,qBAAqB;IACf,GAAG,CAAS;IAE7B;;OAEG;IACH,YAAY,UAAkB;QAC5B,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC/D,CAAC;IAED;;;;;;OAMG;IACH,OAAO,CAAC,UAAkB;QACxB,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,UAAU,EAAE,CAAC,CAAC;QAC7F,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,OAAO,CAAC,CAAC;IACnD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAC,UAAkB;QAC3B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,CAAqB,CAAC;YACpG,OAAO,MAAM,IAAI,MAAM,CAAC,UAAU,KAAK,UAAU,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;QACnG,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK,CAAC,UAA4B;QACtC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,MAAM,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAClG,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,OAAiB,CAAC;QACtB,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,GAAG,GAAuB,EAAE,CAAC;QACnC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YACnC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAAE,SAAS;YACvC,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC3C,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;gBAAE,SAAS;YACxC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACvC,IAAI,UAAU;gBAAE,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF"}

package/dist/cli/backend/src/services/bundle/bundle-team.builder.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Builds the Crewly teams of a solution bundle.
+ *
+ * Mirrors `TemplateService.createTeamFromTemplate` (members per role,
+ * hierarchy wiring) with what bundles need on top: placeholder filling,
+ * deterministic team ids (so every re-run and the CLI find the same team),
+ * ASCII session names like the onboarding starters, and one runtime for
+ * every member.
+ *
+ * @module services/bundle/bundle-team.builder
+ */
+import type { Team, TeamMember } from '../../types/index.js';
+import type { BundleTemplate } from '../../types/solution-bundle.types.js';
+import type { NormalizedBundleTeam } from './bundle-manifest.js';
+import { type BundleAnswers } from './bundle-placeholders.js';
+/**
+ * Lower-case ASCII slug.
+ *
+ * @param value - Any text
+ * @returns Slug (may be empty for non-ASCII text)
+ */
+export declare function toSlug(value: string): string;
+/**
+ * The deterministic id of a bundle team: the template id for the main
+ * team, `<templateId>--<key>` for extra teams.
+ *
+ * @param templateId - Template id
+ * @param teamKey - Team key
+ * @returns Team id
+ */
+export declare function bundleTeamId(templateId: string, teamKey: string): string;
+/**
+ * The member name of the n-th member of a role.
+ *
+ * @param defaultName - Role default name
+ * @param count - Members in the role
+ * @param index - 0-based index
+ * @returns Name (`Writer`, or `Writer1`, `Writer2` …)
+ */
+export declare function memberNameFor(defaultName: string, count: number, index: number): string;
+/**
+ * Values for a team's placeholders: the answers plus the built-ins.
+ *
+ * @param answers - Owner answers
+ * @param teamName - Filled team name
+ * @param leadName - The lead member's name
+ * @returns Placeholder values
+ */
+export declare function teamPlaceholderValues(answers: BundleAnswers, teamName: string, leadName: string): BundleAnswers;
+/** Input of {@link buildBundleTeam}. */
+export interface BuildBundleTeamInput {
+    template: BundleTemplate;
+    team: NormalizedBundleTeam;
+    answers: BundleAnswers;
+    runtime: string;
+    now: Date;
+}
+/**
+ * Build one bundle team (not saved).
+ *
+ * @param input - Template, normalized team, answers, runtime, clock
+ * @returns The team, ready for `StorageService.saveTeam`
+ * @throws BundlePlaceholderError when a text keeps an unfilled placeholder
+ */
+export declare function buildBundleTeam(input: BuildBundleTeamInput): Team;
+/**
+ * Find the member a ref names in a built team.
+ *
+ * @param team - Saved team
+ * @param role - Role id (the first member of the role is returned)
+ * @returns The member, or undefined
+ */
+export declare function memberForRole(team: Team, role: string): TeamMember | undefined;
+/**
+ * The session name a member runs under (its permanent agent id).
+ *
+ * @param member - Member
+ * @returns Session name
+ */
+export declare function memberSession(member: TeamMember): string;
+//# sourceMappingURL=bundle-team.builder.d.ts.map

package/dist/cli/backend/src/services/bundle/bundle-team.builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-team.builder.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/bundle/bundle-team.builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAkB,MAAM,sBAAsB,CAAC;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEhF;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAK5C;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAIxE;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvF;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,CAE/G;AAED,wCAAwC;AACxC,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,cAAc,CAAC;IACzB,IAAI,EAAE,oBAAoB,CAAC;IAC3B,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,IAAI,CAAC;CACX;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAmFjE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAExD"}

package/dist/cli/backend/src/services/bundle/bundle-team.builder.js

@@ -0,0 +1,172 @@
+/**
+ * Builds the Crewly teams of a solution bundle.
+ *
+ * Mirrors `TemplateService.createTeamFromTemplate` (members per role,
+ * hierarchy wiring) with what bundles need on top: placeholder filling,
+ * deterministic team ids (so every re-run and the CLI find the same team),
+ * ASCII session names like the onboarding starters, and one runtime for
+ * every member.
+ *
+ * @module services/bundle/bundle-team.builder
+ */
+import { randomUUID } from 'crypto';
+import { BUNDLE_CONSTANTS } from '../../constants.js';
+import { fillPlaceholders } from './bundle-placeholders.js';
+/**
+ * Lower-case ASCII slug.
+ *
+ * @param value - Any text
+ * @returns Slug (may be empty for non-ASCII text)
+ */
+export function toSlug(value) {
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+/**
+ * The deterministic id of a bundle team: the template id for the main
+ * team, `<templateId>--<key>` for extra teams.
+ *
+ * @param templateId - Template id
+ * @param teamKey - Team key
+ * @returns Team id
+ */
+export function bundleTeamId(templateId, teamKey) {
+    return teamKey === BUNDLE_CONSTANTS.MAIN_TEAM_KEY
+        ? templateId
+        : `${templateId}${BUNDLE_CONSTANTS.TEAM_ID_SEPARATOR}${teamKey}`;
+}
+/**
+ * The member name of the n-th member of a role.
+ *
+ * @param defaultName - Role default name
+ * @param count - Members in the role
+ * @param index - 0-based index
+ * @returns Name (`Writer`, or `Writer1`, `Writer2` …)
+ */
+export function memberNameFor(defaultName, count, index) {
+    return count > 1 ? `${defaultName}${index + 1}` : defaultName;
+}
+/**
+ * Values for a team's placeholders: the answers plus the built-ins.
+ *
+ * @param answers - Owner answers
+ * @param teamName - Filled team name
+ * @param leadName - The lead member's name
+ * @returns Placeholder values
+ */
+export function teamPlaceholderValues(answers, teamName, leadName) {
+    return { ...answers, team_name: teamName, lead_name: leadName };
+}
+/**
+ * Build one bundle team (not saved).
+ *
+ * @param input - Template, normalized team, answers, runtime, clock
+ * @returns The team, ready for `StorageService.saveTeam`
+ * @throws BundlePlaceholderError when a text keeps an unfilled placeholder
+ */
+export function buildBundleTeam(input) {
+    const { template, team, answers, runtime, now } = input;
+    const iso = now.toISOString();
+    const teamId = bundleTeamId(template.id, team.key);
+    const teamSlug = toSlug(teamId) || 'team';
+    const leadRole = team.roles.find((r) => r.role === team.leadRole);
+    const leadName = leadRole ? memberNameFor(leadRole.defaultName, leadRole.count, 0) : '';
+    const nameValues = { ...answers, lead_name: leadName, team_name: '' };
+    const teamName = fillPlaceholders(team.name, nameValues, `team ${team.key} name`);
+    const values = teamPlaceholderValues(answers, teamName, leadName);
+    const members = [];
+    const idsByRole = new Map();
+    for (const role of team.roles) {
+        const ids = [];
+        for (let i = 0; i < role.count; i++) {
+            const id = randomUUID();
+            const name = memberNameFor(role.defaultName, role.count, i);
+            const sessionName = `${teamSlug}-${toSlug(name) || 'member'}-${id.slice(0, 8)}`;
+            const where = `${team.key}/${role.role}`;
+            members.push({
+                id,
+                name,
+                sessionName,
+                agentId: sessionName,
+                role: role.role,
+                systemPrompt: fillPlaceholders(role.promptAdditions ?? '', values, `${where} promptAdditions`),
+                agentStatus: 'inactive',
+                workingStatus: 'idle',
+                runtimeType: runtime,
+                hierarchyLevel: role.hierarchyLevel,
+                canDelegate: role.canDelegate,
+                skillOverrides: role.defaultSkills.length > 0 ? [...role.defaultSkills] : undefined,
+                excludedRoleSkills: role.excludedSkills,
+                createdAt: iso,
+                updatedAt: iso,
+                jobTitle: role.jobTitle ?? role.label,
+                jobDescription: role.jobDescription ? fillPlaceholders(role.jobDescription, values, `${where} jobDescription`) : undefined,
+                ownershipScope: role.ownershipScope,
+                responsibilityType: role.responsibilityType,
+                autonomyLevel: role.autonomyLevel,
+                expertId: role.expertId,
+                domainSOP: role.domainSOP,
+                riskPolicy: role.riskPolicy,
+            });
+            ids.push(id);
+        }
+        idsByRole.set(role.role, ids);
+    }
+    // Hierarchy: every member of a role reports to the first member of its parent role.
+    for (const role of team.roles) {
+        if (!role.reportsTo)
+            continue;
+        const parentId = idsByRole.get(role.reportsTo)?.[0];
+        if (!parentId)
+            continue;
+        const childIds = idsByRole.get(role.role) ?? [];
+        for (const childId of childIds) {
+            const child = members.find((m) => m.id === childId);
+            if (child)
+                child.parentMemberId = parentId;
+        }
+        const parent = members.find((m) => m.id === parentId);
+        if (parent)
+            parent.subordinateIds = [...(parent.subordinateIds ?? []), ...childIds];
+    }
+    const leaderId = idsByRole.get(team.leadRole)?.[0];
+    const description = team.description ? fillPlaceholders(team.description, values, `team ${team.key} description`) : undefined;
+    const mission = team.key === BUNDLE_CONSTANTS.MAIN_TEAM_KEY && template.mission
+        ? fillPlaceholders(template.mission, values, 'mission')
+        : undefined;
+    return {
+        id: teamId,
+        name: teamName,
+        ...(description ? { description } : {}),
+        members,
+        projectIds: [],
+        hierarchical: template.hierarchical ?? true,
+        ...(leaderId ? { leaderId, leaderIds: [leaderId] } : {}),
+        templateId: template.id,
+        ...(mission ? { mission } : {}),
+        createdAt: iso,
+        updatedAt: iso,
+    };
+}
+/**
+ * Find the member a ref names in a built team.
+ *
+ * @param team - Saved team
+ * @param role - Role id (the first member of the role is returned)
+ * @returns The member, or undefined
+ */
+export function memberForRole(team, role) {
+    return team.members.find((m) => m.role === role);
+}
+/**
+ * The session name a member runs under (its permanent agent id).
+ *
+ * @param member - Member
+ * @returns Session name
+ */
+export function memberSession(member) {
+    return member.agentId || member.sessionName;
+}
+//# sourceMappingURL=bundle-team.builder.js.map

package/dist/cli/backend/src/services/bundle/bundle-team.builder.js.map

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

package/dist/cli/backend/src/services/bundle/bundle-time.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Time helpers for bundle first-week tasks: "day 2 at 09:00 in the
+ * bundle's timezone" as a UTC instant, independent of the server's own
+ * timezone (hosted servers run in UTC; owners mostly do not).
+ *
+ * @module services/bundle/bundle-time
+ */
+/** Calendar date and time in some timezone. */
+interface ZonedParts {
+    year: number;
+    month: number;
+    day: number;
+    hour: number;
+    minute: number;
+}
+/**
+ * Whether a string is a valid IANA timezone.
+ *
+ * @param tz - Candidate
+ * @returns True when Intl accepts it
+ */
+export declare function isValidTimezone(tz: string): boolean;
+/**
+ * Calendar parts of an instant in a timezone.
+ *
+ * @param date - Instant
+ * @param tz - IANA timezone
+ * @returns Year, month (1-12), day, hour, minute
+ */
+export declare function zonedParts(date: Date, tz: string): ZonedParts;
+/**
+ * The UTC instant of a wall-clock time in a timezone.
+ *
+ * Starts from the wall time read as UTC, then corrects by the zone's offset
+ * at that instant (twice, which settles DST edges).
+ *
+ * @param wall - Calendar date and time in `tz`
+ * @param tz - IANA timezone
+ * @returns The instant
+ */
+export declare function zonedTimeToUtc(wall: ZonedParts, tz: string): Date;
+/**
+ * When a first-week task is due.
+ *
+ * Day 0 is due at `deployedAt`. Day n is due at `time` (default 09:00) on
+ * the n-th calendar day after the deploy day, in `tz`.
+ *
+ * @param deployedAt - When the bundle was applied
+ * @param day - 0-based day
+ * @param time - `HH:MM` (optional)
+ * @param tz - IANA timezone
+ * @returns ISO timestamp
+ *
+ * @example
+ * firstWeekDueAt(new Date('2026-09-25T02:00:00Z'), 1, '09:00', 'Asia/Shanghai') // '2026-09-26T01:00:00.000Z'
+ */
+export declare function firstWeekDueAt(deployedAt: Date, day: number, time: string | undefined, tz: string): string;
+export {};
+//# sourceMappingURL=bundle-time.d.ts.map

package/dist/cli/backend/src/services/bundle/bundle-time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-time.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/bundle/bundle-time.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,+CAA+C;AAC/C,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAQnD;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,CAmB7D;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CASjE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAU1G"}