Method create

src/workspaces/workspace-creator.ts:98–277

(
    tag: string,
    templateName: string,
    agentsRequested?: readonly string[],
  )

  constructor(private readonly opts: CreatorOptions) {}

  async create(
    tag: string,
    templateName: string,
    agentsRequested?: readonly string[],
  ): Promise<CreateResult> {
    if (!TAG_RE.test(tag)) {
      return {
        ok: false,
        code: 'invalid_tag',
        message: `tag must match ${TAG_RE.source}`,
      };
    }
    if (this.opts.registry.hasTag(tag)) {
      return { ok: false, code: 'tag_in_use', message: `tag in use: ${tag}` };
    }
    const template = this.opts.templateRegistry.get(templateName);
    if (!template) {
      return {
        ok: false,
        code: 'unknown_template',
        message: `unknown template: ${templateName}`,
      };
    }

    // Agent policy lives in `resolveCreateAgents` (this file) so every create
    // path — form, quick-chat, headless — converges on it.
    const agents = resolveCreateAgents(
      agentsRequested,
      template.defaultAgents,
      this.opts.adapterRegistry.list().map((a) => a.id),
    );

    // Validate every requested adapter exists in the registry.
    for (const a of agents) {
      if (!this.opts.adapterRegistry.get(a)) {
        return {
          ok: false,
          code: 'unknown_agent',
          message: `unknown agent: ${a}`,
        };
      }
    }

    const id = generatePetnameId(templateName, {
      fallbackPrefix: 'workspace',
      isTaken: (candidate) =>
        this.opts.registry.hasId(candidate) ||
        existsSync(join(this.opts.workspacesRoot, candidate)),
    });
    const dir = join(this.opts.workspacesRoot, id);
    const log = this.opts.logger.child({ tag, id, dir, template: templateName, agents });

    log.info('bootstrap.start', { script: template.bootstrapScript });

    const result = await runScript(
      template.bootstrapScript,
      [tag, dir],
      {