@powerhousedao/ph-clint-cli 0.1.0-dev.5 → 0.1.0-dev.51

package/dist/codegen/builders/agent-ts.js

@@ -1,5 +1,20 @@
-export function buildAgentTs(spec) {
-    const id = spec.name;
+/** Map provider prefix to AI SDK package. */
+function providerImport(provider) {
+    switch (provider) {
+        case 'anthropic':
+            return { pkg: '@ai-sdk/anthropic', fn: 'anthropic' };
+        case 'openai':
+            return { pkg: '@ai-sdk/openai', fn: 'openai' };
+        case 'google':
+            return { pkg: '@ai-sdk/google', fn: 'google' };
+        default:
+            return { pkg: `@ai-sdk/${provider}`, fn: provider };
+    }
+}
+function buildDemoAgent(spec) {
+    const mastra = spec.features.mastra;
+    const id = mastra.agentId ?? spec.name;
+    const name = mastra.agentName ?? id;
     return [
         "import type { AgentProvider, AgentSetupContext, StreamChunk } from '@powerhousedao/ph-clint';",
         "import type { Config } from '../framework.js';",
@@ -11,6 +26,7 @@ export function buildAgentTs(spec) {
         'function createDemoAgent(): AgentProvider {',
         '  return {',
         `    id: '${id}',`,
+        `    name: '${name}',`,
         '    async *stream(prompt) {',
         '      yield {',
         "        type: 'text-delta',",
@@ -32,3 +48,77 @@ export function buildAgentTs(spec) {
         '',
     ].join('\n');
 }
+function buildRealAgent(spec) {
+    const mastra = spec.features.mastra;
+    const agentId = mastra.agentId;
+    const agentName = mastra.agentName;
+    const defaultModel = mastra.models.find(m => m.isDefault) ?? mastra.models[0];
+    const modelId = defaultModel?.id ?? 'anthropic/claude-sonnet-4-5';
+    const [provider] = modelId.split(/[:/]/);
+    const { pkg, fn } = providerImport(provider);
+    const apiKeyField = `${provider}ApiKey`;
+    const lines = [];
+    lines.push("import { Agent } from '@mastra/core/agent';");
+    lines.push("import { MCPClient } from '@mastra/mcp';");
+    lines.push("import { createMastraHelpers } from '@powerhousedao/ph-clint/mastra';");
+    lines.push("import { createWorkdirStore } from '@powerhousedao/ph-clint';");
+    lines.push("import type { AgentSetupContext, AgentProvider } from '@powerhousedao/ph-clint';");
+    lines.push("import type { WrapAgentOptions } from '@powerhousedao/ph-clint/mastra';");
+    lines.push("import { CLI_NAME } from '../config.js';");
+    lines.push("import type { Config } from '../framework.js';");
+    lines.push("import { createDemoAgent } from './demo-agent.js';");
+    lines.push('');
+    lines.push('/**');
+    lines.push(' * Agent factory for the CLI.');
+    lines.push(' *');
+    lines.push(' * Returns a demo agent when no API key is configured, or wraps the full');
+    lines.push(' * agent as a ph-clint AgentProvider.');
+    lines.push(' */');
+    lines.push('export async function createAgent(ctx: AgentSetupContext<Config>): Promise<AgentProvider> {');
+    lines.push(`  if (!ctx.config.${apiKeyField}) return createDemoAgent();`);
+    lines.push('');
+    lines.push('  const m = createMastraHelpers(ctx);');
+    lines.push('');
+    lines.push('  const agent = new Agent({');
+    lines.push(`    id: '${agentId}',`);
+    lines.push(`    name: '${agentName}',`);
+    lines.push(`    instructions: m.getAgentInstructions('${agentId}'),`);
+    lines.push(`    model: ctx.config.${apiKeyField}`);
+    lines.push(`      ? { id: ctx.config.model as \`\${string}/\${string}\`, apiKey: ctx.config.${apiKeyField} }`);
+    lines.push(`      : (ctx.config.model as \`\${string}/\${string}\`),`);
+    lines.push('    tools: async () => {');
+    lines.push("      ctx.context.log?.debug('[agent] tools callback invoked');");
+    lines.push('      const tools = await m.getTools({ MCPClient });');
+    lines.push("      ctx.context.log?.debug(`[agent] tools resolved: ${Object.keys(tools).length} tools`);");
+    lines.push('      return tools;');
+    lines.push('    },');
+    lines.push('    workspace: await m.createWorkspace(),');
+    lines.push('    memory: await m.createMemory(),');
+    lines.push('  });');
+    lines.push('');
+    lines.push('  const store = createWorkdirStore(ctx.workdir, CLI_NAME);');
+    lines.push('  const wrapOpts: WrapAgentOptions = {');
+    lines.push('    maxSteps: 80,');
+    lines.push('    enableLogging: ctx.config.agentLogging,');
+    lines.push("    logDirectory: store.getStoreFolder('logs'),");
+    lines.push('    cacheControl: true,');
+    if (mastra.agentDescription) {
+        lines.push(`    description: ${JSON.stringify(mastra.agentDescription)},`);
+    }
+    if (mastra.agentImage) {
+        lines.push(`    image: ${JSON.stringify(mastra.agentImage)},`);
+    }
+    lines.push('  };');
+    lines.push('  return m.wrapAgent(agent, wrapOpts);');
+    lines.push('}');
+    lines.push('');
+    return lines.join('\n');
+}
+export function buildAgentTs(spec) {
+    const mastra = spec.features.mastra;
+    // Generate real agent when we have full config, demo otherwise
+    if (mastra.agentId && mastra.models.length > 0) {
+        return buildRealAgent(spec);
+    }
+    return buildDemoAgent(spec);
+}

package/dist/codegen/builders/app-index-ts.d.ts

@@ -3,16 +3,9 @@
  * reactor package. Impl code imports from `'{name}-app'` instead of drilling
  * into `'{name}-app/document-models/<slug>/v1/gen/...'`.
  *
- * Each entry re-exports a document-model subfolder's `index.ts`, which in
- * turn re-exports the module object (`PhClintProject`, ...), action creators,
- * document/state types, and type guards. Fully machine-owned: regen on every
- * run.
- *
- * Powerhouse's own codegen might emit its own `index.ts` (as is the case for
- * ph-clint-app today, which has manifest/editors/processors re-exports). When
- * that exists, leave it alone — users hand-merge. Our codegen only emits when
- * the file is absent or was emitted by a previous ph-clint-cli run (hash
- * matches the ledger).
+ * Only re-exports document types belonging to the app package (the project's
+ * own reactor package). External packages' document types are imported from
+ * their own npm packages, not from the app barrel.
  */
 import { type ClintProjectSpec } from '../../spec/types.js';
 export declare function buildAppIndexTs(spec: ClintProjectSpec): string | null;

package/dist/codegen/builders/app-index-ts.js

@@ -3,29 +3,25 @@
  * reactor package. Impl code imports from `'{name}-app'` instead of drilling
  * into `'{name}-app/document-models/<slug>/v1/gen/...'`.
  *
- * Each entry re-exports a document-model subfolder's `index.ts`, which in
- * turn re-exports the module object (`PhClintProject`, ...), action creators,
- * document/state types, and type guards. Fully machine-owned: regen on every
- * run.
- *
- * Powerhouse's own codegen might emit its own `index.ts` (as is the case for
- * ph-clint-app today, which has manifest/editors/processors re-exports). When
- * that exists, leave it alone — users hand-merge. Our codegen only emits when
- * the file is absent or was emitted by a previous ph-clint-cli run (hash
- * matches the ledger).
+ * Only re-exports document types belonging to the app package (the project's
+ * own reactor package). External packages' document types are imported from
+ * their own npm packages, not from the app barrel.
  */
-import { getDocumentTypeSlug, } from '../../spec/types.js';
+import { getAppPackageName, getDocumentTypeSlug, phAtLeast, } from '../../spec/types.js';
 export function buildAppIndexTs(spec) {
-    if (!spec.features.powerhouse.enabled)
+    if (!phAtLeast(spec.features.powerhouse, 'Reactor'))
         return null;
-    if (spec.documentTypes.length === 0)
+    const appPkg = getAppPackageName(spec);
+    const appEntry = spec.packages.find((p) => p.packageName === appPkg);
+    const docTypes = appEntry?.documentTypes ?? [];
+    if (docTypes.length === 0)
         return null;
     const lines = [];
     lines.push('// THIS FILE IS GENERATED BY ph-clint-cli.');
     lines.push('// Re-exports every registered document model from a single top-level');
     lines.push('// entry so impl code can `import { ... } from \'{name}-app\'`.');
     lines.push('');
-    for (const docType of spec.documentTypes) {
+    for (const docType of docTypes) {
         const slug = getDocumentTypeSlug(docType);
         lines.push(`export * from './document-models/${slug}/index.js';`);
     }

package/dist/codegen/builders/cli-package-json.js

@@ -4,8 +4,9 @@
  * When `features.powerhouse.enabled`, this file lives at
  * `{root}/{name}-cli/package.json`. Otherwise at `{root}/package.json`.
  */
-import { getBinName, getPackageName, } from '../../spec/types.js';
+import { getAppDirName, getAppPackageName, getBinName, getPackageName, phAtLeast, } from '../../spec/types.js';
 import { CLI_VERSION } from '../../config.js';
+import { getPhVersion } from '../scaffold.js';
 /**
  * Derive a semver range from the running ph-clint-cli version that respects
  * the dev / staging / production channel boundary. This is the version range
@@ -31,16 +32,24 @@ function phClintRange(version) {
         return `^${version}`;
     const base = match[1];
     const channel = match[2]; // "dev", "staging", or undefined
-    return channel ? `^${base}-${channel}.0` : `^${base}`;
+    // For prerelease channels, pin exact version. Caret ranges like ^0.1.0-dev.0
+    // resolve to `latest` dist-tag (0.1.0-dev.0) instead of the highest match,
+    // causing "export not found" errors when the scaffolding CLI is newer.
+    return channel ? version : `^${base}`;
 }
 /** Version range for @powerhousedao/ph-clint{,-dev} deps in scaffolded projects. */
 const PH_CLINT_VERSION = phClintRange(CLI_VERSION);
-const POWERHOUSE_VERSION = '6.0.0-dev.170';
+const POWERHOUSE_VERSION_FALLBACK = '6.0.0-dev.170';
+let _powerhouseVersion;
+function getPowerhouseVersion() {
+    if (_powerhouseVersion === undefined) {
+        _powerhouseVersion = getPhVersion('ph') ?? POWERHOUSE_VERSION_FALLBACK;
+    }
+    return _powerhouseVersion;
+}
 export function buildCliPackageJson(spec) {
     const { mastra, powerhouse } = spec.features;
-    const pkgName = powerhouse.enabled
-        ? `${getPackageName(spec)}-cli`
-        : getPackageName(spec);
+    const pkgName = getPackageName(spec);
     const bin = getBinName(spec);
     const dependencies = {
         '@powerhousedao/ph-clint': PH_CLINT_VERSION,
@@ -49,18 +58,32 @@ export function buildCliPackageJson(spec) {
     if (mastra.enabled) {
         dependencies['@mastra/core'] = '^1.22.0';
         dependencies['@mastra/libsql'] = '^1.7.4';
+        dependencies['@mastra/mcp'] = '^1.4.1';
         dependencies['@mastra/memory'] = '^1.13.1';
     }
-    if (powerhouse.enabled) {
-        dependencies[`${spec.name}-app`] = `file:../${spec.name}-app`;
-        dependencies['@powerhousedao/reactor'] = POWERHOUSE_VERSION;
-        dependencies['@powerhousedao/reactor-api'] = POWERHOUSE_VERSION;
-        dependencies['@powerhousedao/shared'] = POWERHOUSE_VERSION;
-        dependencies['document-model'] = POWERHOUSE_VERSION;
+    if (phAtLeast(powerhouse, 'Reactor')) {
+        const appPkg = getAppPackageName(spec);
+        const appDir = getAppDirName(spec);
+        dependencies[appPkg] = `file:../${appDir}`;
+        dependencies['@powerhousedao/reactor'] = getPowerhouseVersion();
+        dependencies['@powerhousedao/reactor-api'] = getPowerhouseVersion();
+        dependencies['@powerhousedao/shared'] = getPowerhouseVersion();
+        dependencies['document-model'] = getPowerhouseVersion();
+        // External reactor packages (non-app) as versioned dependencies.
+        // Compare bare names (without scope) so that a spec entry with
+        // packageName "foo-app" still matches the scoped "@scope/foo-app".
+        const appBare = appPkg.replace(/^@[^/]+\//, '');
+        for (const pkg of spec.packages) {
+            const pkgBare = pkg.packageName.replace(/^@[^/]+\//, '');
+            if (pkgBare === appBare)
+                continue;
+            dependencies[pkg.packageName] = 'latest';
+        }
     }
     const scripts = {
         'build:skills': 'tsx scripts/build-skills.ts',
-        build: 'pnpm build:skills && tsc',
+        'build:manifest': 'build-manifest',
+        build: 'pnpm build:skills && tsc && pnpm build:manifest',
         dev: 'tsx src/main.ts',
         start: 'node dist/main.js',
         test: "NODE_OPTIONS='--experimental-vm-modules' jest --detectOpenHandles",
@@ -71,15 +94,23 @@ export function buildCliPackageJson(spec) {
         scripts['mastra:build'] = 'mastra build';
         scripts['mastra:start'] = 'mastra start';
     }
+    // Single-layout: publish scripts live in the CLI package.json (which IS the
+    // root). Split-layout gets these from root-package-json.ts instead.
+    if (!phAtLeast(powerhouse, 'Reactor')) {
+        scripts['publish:dev'] = 'ph-publish dev -c ./publish.config.js';
+        scripts['publish:staging'] = 'ph-publish staging -c ./publish.config.js';
+        scripts['publish:production'] = 'ph-publish production -c ./publish.config.js';
+    }
     const pkg = {
         name: pkgName,
         version: spec.version,
-        private: true,
+        publishConfig: { access: 'public' },
         type: 'module',
     };
     if (spec.description)
         pkg.description = spec.description;
     pkg.bin = { [bin]: './dist/main.js' };
+    pkg.files = ['dist'];
     pkg.scripts = scripts;
     pkg.dependencies = dependencies;
     pkg.devDependencies = {
@@ -90,6 +121,7 @@ export function buildCliPackageJson(spec) {
         'ts-jest': '^29.4.6',
         tsx: '^4.19.0',
         typescript: '^6.0.2',
+        'typescript-eslint': '^8.33.0',
     };
     pkg.engines = { node: '>=22.13.0' };
     return JSON.stringify(pkg, null, 2) + '\n';

package/dist/codegen/builders/cli-ts.js

@@ -1,5 +1,17 @@
+/**
+ * Builds `src/cli.ts` — the defineCli() call with feature blocks guarded by
+ * `@clint:begin`/`@clint:end` markers so the code generator can patch
+ * specific regions on subsequent runs (delta mode — future phase).
+ */
+import { getAppPackageName, phAtLeast } from '../../spec/types.js';
+/** External packages that have document types (not the app package). */
+function getExternalPackages(spec) {
+    const appPkg = getAppPackageName(spec);
+    return spec.packages.filter((p) => p.packageName !== appPkg && p.documentTypes.length > 0);
+}
 export function buildCliTs(spec) {
     const { mastra, routine, powerhouse } = spec.features;
+    const ph = powerhouse;
     const lines = [];
     lines.push('/**');
     lines.push(' * CLI definition.');
@@ -8,32 +20,42 @@ export function buildCliTs(spec) {
     lines.push(' * markers are rewritten by ph-clint when the project spec changes.');
     lines.push(' * Everything outside the markers is user-editable and preserved.');
     lines.push(' */');
-    if (powerhouse.enabled) {
-        lines.push(`import path from 'node:path';`);
-        lines.push(`import { defineCli, buildDefaultReactor } from '@powerhousedao/ph-clint';`);
-    }
-    else {
-        lines.push(`import { defineCli } from '@powerhousedao/ph-clint';`);
+    const needsRoot = phAtLeast(ph, 'Reactor') || mastra.enabled;
+    lines.push('// @clint:begin imports');
+    const phClintImports = ['defineCli'];
+    if (phAtLeast(ph, 'Reactor'))
+        phClintImports.push('buildDefaultReactor');
+    // proxy has no additional imports
+    lines.push(`import { ${phClintImports.join(', ')} } from '@powerhousedao/ph-clint';`);
+    if (needsRoot) {
+        lines.push("import path from 'node:path';");
     }
-    lines.push(`import { CLI_NAME, CLI_VERSION${powerhouse.enabled ? ', CLI_ROOT' : ''} } from './config.js';`);
+    lines.push(`import { CLI_NAME, CLI_VERSION${needsRoot ? ', CLI_ROOT' : ''} } from './config.js';`);
     lines.push(`import { configSchema, secretsSchema } from './framework.js';`);
-    lines.push('');
-    lines.push('// @clint:begin imports');
-    if (powerhouse.enabled) {
-        lines.push(`import { documentModels } from '${spec.name}-app';`);
+    if (phAtLeast(ph, 'Reactor')) {
+        lines.push(`import { documentModels } from '${getAppPackageName(spec)}';`);
+        const extPkgs = getExternalPackages(spec);
+        for (let i = 0; i < extPkgs.length; i++) {
+            const alias = extPkgs.length === 1 ? 'extModels' : `extModels${i}`;
+            lines.push(`import { documentModels as ${alias} } from '${extPkgs[i].packageName}';`);
+        }
     }
     if (mastra.enabled) {
         lines.push(`import { createAgent } from './agents/agent.js';`);
     }
+    if (mastra.enabled && mastra.common?.enableChat) {
+        lines.push(`import { chatSessionWatchTrigger } from '@powerhousedao/clint-common/chat';`);
+    }
     lines.push('// @clint:end imports');
     lines.push('');
-    if (powerhouse.enabled) {
-        lines.push(`const appDir = path.resolve(CLI_ROOT, '../${spec.name}-app');`);
-        lines.push('');
-    }
     lines.push('export const cli = defineCli({');
     lines.push('  name: CLI_NAME,');
     lines.push('  version: CLI_VERSION,');
+    lines.push('  // @clint:begin root');
+    if (phAtLeast(ph, 'Reactor')) {
+        lines.push('  root: CLI_ROOT,');
+    }
+    lines.push('  // @clint:end root');
     lines.push('  description: `${CLI_NAME} v${CLI_VERSION}`,');
     lines.push('  configSchema,');
     lines.push('  secretsSchema,');
@@ -47,8 +69,8 @@ export function buildCliTs(spec) {
     lines.push('  // @clint:end services');
     lines.push('');
     lines.push('  // @clint:begin triggers');
-    if (routine.enabled) {
-        lines.push('  triggers: [],');
+    if (mastra.enabled && mastra.common?.enableChat) {
+        lines.push('  triggers: [chatSessionWatchTrigger],');
     }
     else {
         lines.push('  triggers: [],');
@@ -57,8 +79,34 @@ export function buildCliTs(spec) {
     lines.push('');
     lines.push('  // @clint:begin prompts');
     lines.push('  prompts: {');
-    lines.push('    sources: [],');
-    lines.push('    agents: {},');
+    if (mastra.enabled) {
+        lines.push("    artifacts: [path.join(CLI_ROOT, 'gen', 'skills'), path.join(CLI_ROOT, 'dist', 'gen', 'skills')],");
+    }
+    else {
+        lines.push('    artifacts: [],');
+    }
+    if (mastra.enabled && mastra.agentId) {
+        lines.push('    agents: {');
+        lines.push(`      '${mastra.agentId}': {`);
+        if (mastra.profiles.length > 0) {
+            lines.push(`        name: '${mastra.profiles[0].id}',`);
+            lines.push('        sections: [');
+            for (const p of mastra.profiles) {
+                lines.push(`          '${p.id}.md',`);
+            }
+            lines.push('        ],');
+        }
+        else {
+            lines.push("        name: 'AgentBase',");
+            lines.push("        sections: ['AgentBase.md'],");
+        }
+        lines.push('        skills: [],');
+        lines.push('      },');
+        lines.push('    },');
+    }
+    else {
+        lines.push('    agents: {},');
+    }
     lines.push('    skills: {},');
     lines.push('  },');
     lines.push('  // @clint:end prompts');
@@ -67,6 +115,12 @@ export function buildCliTs(spec) {
     lines.push('  events: {},');
     lines.push('  // @clint:end events');
     lines.push('');
+    lines.push('  // @clint:begin proxy');
+    if (spec.deployment.proxyEnabled) {
+        lines.push('  proxyEnabled: true,');
+    }
+    lines.push('  // @clint:end proxy');
+    lines.push('');
     lines.push('  // @clint:begin interactive');
     lines.push('  interactive: {');
     lines.push(`    welcome: ({ workdir }) =>`);
@@ -75,10 +129,10 @@ export function buildCliTs(spec) {
     lines.push('        `Workdir: ${workdir}`,');
     lines.push("        '',");
     if (mastra.enabled) {
-        lines.push("        'Type a message to talk to the agent, or /help for commands.',");
+        lines.push("        'Type a message to talk to the agent, or / for commands.',");
     }
     else {
-        lines.push("        'Type /help for commands.',");
+        lines.push("        'Type / for commands or /cli-docs for help.',");
     }
     lines.push("      ].join('\\n'),");
     lines.push('  },');
@@ -86,15 +140,23 @@ export function buildCliTs(spec) {
     lines.push('});');
     lines.push('');
     lines.push('// @clint:begin reactor');
-    if (powerhouse.enabled) {
+    if (phAtLeast(ph, 'Reactor')) {
         lines.push('cli.configureReactor({');
         lines.push('  create: (ctx) =>');
         lines.push('    buildDefaultReactor(ctx, {');
-        lines.push('      documentModels,');
+        const extPkgs = getExternalPackages(spec);
+        if (extPkgs.length === 0) {
+            lines.push('      documentModels,');
+        }
+        else {
+            const aliases = extPkgs.map((_, i) => extPkgs.length === 1 ? 'extModels' : `extModels${i}`);
+            lines.push(`      documentModels: [...documentModels, ${aliases.map(a => `...${a}`).join(', ')}],`);
+        }
         lines.push(`      drive: { name: '${spec.name}' },`);
+        lines.push('      subscriptions: {},');
         lines.push('    }),');
-        lines.push(`  switchboard: { enabled: ${String(powerhouse.switchboard)} },`);
-        lines.push(`  connect: { enabled: ${String(powerhouse.connect)}, workdir: appDir },`);
+        lines.push(`  switchboard: { enabled: ${String(phAtLeast(ph, 'Switchboard'))} },`);
+        lines.push(`  connect: { enabled: ${String(phAtLeast(ph, 'Connect'))} },`);
         lines.push('});');
     }
     lines.push('// @clint:end reactor');

package/dist/codegen/builders/config-ts.d.ts

@@ -5,4 +5,4 @@
  * can extend them without fighting the generator.
  */
 import { type ClintProjectSpec } from '../../spec/types.js';
-export declare function buildConfigTs(spec: ClintProjectSpec): string;
+export declare function buildConfigTs(_spec: ClintProjectSpec): string;

package/dist/codegen/builders/config-ts.js

@@ -1,17 +1,11 @@
-export function buildConfigTs(spec) {
-    const hasCustomBin = !!spec.bin;
+export function buildConfigTs(_spec) {
     const lines = [];
     lines.push(`import { readPackageInfo } from '@powerhousedao/ph-clint';`);
     lines.push('');
     lines.push('const pkg = readPackageInfo(import.meta.url);');
     lines.push('');
     lines.push('export const CLI_ROOT = pkg.root;');
-    if (hasCustomBin) {
-        lines.push(`export const CLI_NAME = '${spec.bin}';`);
-    }
-    else {
-        lines.push(`export const CLI_NAME = pkg.name.replace(/-cli$/, '');`);
-    }
+    lines.push(`export const CLI_NAME = pkg.name.replace(/-cli$/, '');`);
     lines.push('export const CLI_VERSION = pkg.version;');
     return lines.join('\n') + '\n';
 }

package/dist/codegen/builders/demo-agent-ts.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Builds `src/agents/demo-agent.ts` — a deterministic echo agent fallback.
+ *
+ * Generated when `features.mastra.enabled` with full agent config so the real
+ * agent factory can fall back to demo mode when no API key is configured.
+ */
+import { type ClintProjectSpec } from '../../spec/types.js';
+export declare function buildDemoAgentTs(spec: ClintProjectSpec): string | null;

package/dist/codegen/builders/demo-agent-ts.js

@@ -0,0 +1,50 @@
+export function buildDemoAgentTs(spec) {
+    const { mastra } = spec.features;
+    // Only needed alongside the real agent (which imports it)
+    if (!mastra.enabled || !mastra.agentId || mastra.models.length === 0)
+        return null;
+    const agentId = mastra.agentId;
+    const agentName = mastra.agentName ?? agentId;
+    const agentDescription = mastra.agentDescription;
+    const agentImage = mastra.agentImage;
+    return [
+        "import type { AgentProvider, StreamChunk } from '@powerhousedao/ph-clint';",
+        '',
+        '/**',
+        ' * Demo agent — deterministic echo responses without an API key.',
+        ' *',
+        ' * Echoes user prompts with conversation tracking per thread.',
+        ' */',
+        'export function createDemoAgent(): AgentProvider {',
+        '  const conversations = new Map<string, string[]>();',
+        '',
+        '  return {',
+        `    id: '${agentId}',`,
+        `    name: '${agentName}',`,
+        ...(agentDescription ? [`    description: ${JSON.stringify(agentDescription)},`] : []),
+        ...(agentImage ? [`    image: ${JSON.stringify(agentImage)},`] : []),
+        '    async *stream(prompt, opts) {',
+        "      const threadId = opts?.threadId ?? 'default';",
+        '      if (!conversations.has(threadId)) {',
+        '        conversations.set(threadId, []);',
+        '      }',
+        '      const history = conversations.get(threadId)!;',
+        '      history.push(prompt);',
+        '',
+        '      const turnCount = history.length;',
+        '      if (turnCount > 1) {',
+        '        yield {',
+        "          type: 'text-delta',",
+        '          text: `I understand you\'re continuing our conversation (turn ${turnCount}). `,',
+        '        } satisfies StreamChunk;',
+        '      }',
+        '      yield {',
+        "        type: 'text-delta',",
+        '        text: `You said: "${prompt}". I\'m the demo agent — set an API key for real LLM responses.`,',
+        '      } satisfies StreamChunk;',
+        '    },',
+        '  };',
+        '}',
+        '',
+    ].join('\n');
+}

package/dist/codegen/builders/eslint-config-js.d.ts

@@ -1,4 +1,4 @@
 /**
- * Builds `eslint.config.js` for the CLI — placeholder flat config.
+ * Builds `eslint.config.js` for the CLI — minimal TypeScript-ESLint config.
  */
 export declare function buildEslintConfigJs(): string;

package/dist/codegen/builders/eslint-config-js.js

@@ -1,12 +1,15 @@
 /**
- * Builds `eslint.config.js` for the CLI — placeholder flat config.
+ * Builds `eslint.config.js` for the CLI — minimal TypeScript-ESLint config.
  */
 export function buildEslintConfigJs() {
     return [
         '// @clint:begin eslint',
-        '// Placeholder ESLint flat config — replaced by codegen when the',
-        "// project's lint stack is configured.",
-        'export default [];',
+        "import tseslint from 'typescript-eslint';",
+        '',
+        'export default tseslint.config(',
+        '  tseslint.configs.recommended,',
+        "  { ignores: ['dist/', 'gen/', 'coverage/'] },",
+        ');',
         '// @clint:end eslint',
         '',
     ].join('\n');

package/dist/codegen/builders/framework-gen-ts.d.ts

@@ -4,14 +4,13 @@
  * `defineRegistry([...] as const)` call that describes which document models
  * are bound into `framework.ts`'s typed factories.
  *
- * Kept deliberately small: this file exports only `registry` and the
- * `Registry` type. The `createTypes` call lives in `framework.ts` (the
- * user-owned half) so `configSchema` edits stay local and we avoid an import
- * cycle between the two files.
+ * Iterates all packages' document types. The app package's modules are
+ * imported from the local `{name}-app` package; external packages' modules
+ * are imported from their npm package name.
  *
  * Emitted only when Powerhouse is enabled — flat-layout impls have no
  * reactor package to import modules from and bind `createTypes` directly in
- * `framework.ts`. When Powerhouse is on but no `documentTypes` are declared,
+ * `framework.ts`. When Powerhouse is on but no document types are declared,
  * we still emit this file with an empty `defineRegistry([])` so impl code's
  * `import { registry } from './framework.gen.js'` keeps resolving across
  * regens.