@powerhousedao/ph-clint-cli 0.1.0-dev.22 → 0.1.0-dev.23

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

@@ -1,9 +1,9 @@
 /**
- * Builds `src/agents/agent.ts` — a minimal Mastra agent factory.
+ * Builds `src/agents/agent.ts` — a Mastra agent factory.
  *
- * Emitted only when `features.mastra.enabled`. The generated agent falls back
- * to a deterministic echo-style demo provider when no API key is configured,
- * so `pnpm dev` works immediately out of the box.
+ * Emitted only when `features.mastra.enabled`. When the spec includes agent
+ * config (agentId, models, profiles), generates a real `@mastra/core` Agent.
+ * Otherwise falls back to a deterministic echo-style demo provider.
  */
 import { type ClintProjectSpec } from '../../spec/types.js';
 export declare function buildAgentTs(spec: ClintProjectSpec): string;

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

@@ -1,5 +1,18 @@
-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 id = spec.features.mastra.agentId ?? spec.name;
     return [
         "import type { AgentProvider, AgentSetupContext, StreamChunk } from '@powerhousedao/ph-clint';",
         "import type { Config } from '../framework.js';",
@@ -32,3 +45,71 @@ 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 envKey = `${provider.toUpperCase()}_API_KEY`;
+    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.apiKey) 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.apiKey');
+    lines.push("      ? { id: ctx.config.model as `${string}/${string}`, apiKey: ctx.config.apiKey }");
+    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,');
+    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/cli-ts.js

@@ -63,7 +63,20 @@ export function buildCliTs(spec) {
     lines.push('  // @clint:begin prompts');
     lines.push('  prompts: {');
     lines.push('    artifacts: [],');
-    lines.push('    agents: {},');
+    if (mastra.enabled && mastra.agentId && mastra.profiles.length > 0) {
+        lines.push('    agents: {');
+        lines.push(`      '${mastra.agentId}': {`);
+        lines.push('        sections: [');
+        for (const p of mastra.profiles) {
+            lines.push(`          { id: '${p.id}', title: '${p.title}', file: '${p.id}.md' },`);
+        }
+        lines.push('        ],');
+        lines.push('      },');
+        lines.push('    },');
+    }
+    else {
+        lines.push('    agents: {},');
+    }
     lines.push('    skills: {},');
     lines.push('  },');
     lines.push('  // @clint:end prompts');

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

@@ -43,7 +43,8 @@ export function buildFrameworkTs(spec) {
     lines.push('');
     lines.push('export const configSchema = z.object({');
     if (mastra.enabled) {
-        lines.push("  model: z.string().default('anthropic/claude-haiku-4-5').describe('LLM model to use'),");
+        const defaultModel = mastra.models.find(m => m.isDefault)?.id ?? 'anthropic/claude-sonnet-4-5';
+        lines.push(`  model: z.string().default('${defaultModel}').describe('LLM model to use'),`);
     }
     // Ports are derived from CLI name by resolveReactorDefaults() — no config fields needed.
     // Override via switchboard.port / connect.port in configureReactor() if required.

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

@@ -36,6 +36,11 @@ export interface FileBuilder {
      */
     initOnly?: boolean;
 }
+/**
+ * Generate dynamic file builders for agent profile markdown files.
+ * One file per profile in `prompts/agent-profiles/{id}.md`.
+ */
+export declare function getProfileFileBuilders(spec: ClintProjectSpec): FileBuilder[];
 export declare const CLI_FILE_BUILDERS: FileBuilder[];
 export { buildCliPackageJson, buildCliTs, buildConfigTs, buildMainTs, buildTsconfigJson, buildJestConfigJs, buildEslintConfigJs, buildGitignore, buildMastraIndexTs, buildBuildSkillsScript, buildAgentBaseMd, buildAgentTs, buildFrameworkGenTs, buildFrameworkTs, };
 export { buildRootPackageJson } from './root-package-json.js';

package/dist/codegen/builders/index.js

@@ -19,6 +19,19 @@ import { buildAgentBaseMd } from './agent-base-md.js';
 import { buildAgentTs } from './agent-ts.js';
 import { buildFrameworkGenTs } from './framework-gen-ts.js';
 import { buildFrameworkTs } from './framework-ts.js';
+/**
+ * Generate dynamic file builders for agent profile markdown files.
+ * One file per profile in `prompts/agent-profiles/{id}.md`.
+ */
+export function getProfileFileBuilders(spec) {
+    const { mastra } = spec.features;
+    if (!mastra.enabled || mastra.profiles.length === 0)
+        return [];
+    return mastra.profiles.map((profile) => ({
+        relativePath: `prompts/agent-profiles/${profile.id}.md`,
+        build: () => profile.content + '\n',
+    }));
+}
 export const CLI_FILE_BUILDERS = [
     { relativePath: 'package.json', build: buildCliPackageJson },
     { relativePath: 'tsconfig.json', build: () => buildTsconfigJson() },
@@ -34,7 +47,10 @@ export const CLI_FILE_BUILDERS = [
     { relativePath: 'src/framework.gen.ts', build: buildFrameworkGenTs },
     { relativePath: 'src/mastra/index.ts', build: buildMastraIndexTs },
     { relativePath: 'scripts/build-skills.ts', build: () => buildBuildSkillsScript() },
-    { relativePath: 'prompts/agent-profiles/AgentBase.md', build: buildAgentBaseMd },
+    {
+        relativePath: 'prompts/agent-profiles/AgentBase.md',
+        build: (spec) => (spec.features.mastra.profiles.length > 0 ? null : buildAgentBaseMd(spec)),
+    },
     {
         relativePath: 'src/agents/agent.ts',
         build: (spec) => (spec.features.mastra.enabled ? buildAgentTs(spec) : null),

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

@@ -3,6 +3,9 @@
  *
  * When Mastra is off, emit a no-op placeholder so the directory still exists
  * and `mastra dev` fails predictably rather than importing partial code.
+ *
+ * When Mastra is on with full agent config, emit a real Mastra instance
+ * that registers the agent.
  */
 import { type ClintProjectSpec } from '../../spec/types.js';
 export declare function buildMastraIndexTs(spec: ClintProjectSpec): string;

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

@@ -12,9 +12,29 @@ export function buildMastraIndexTs(spec) {
             '',
         ].join('\n');
     }
-    // When Mastra is enabled but we still emit the demo `AgentProvider` shim
-    // (not a real `@mastra/core` Agent), there is no `mastra` export yet —
-    // `mastra dev` will surface a helpful message once you wire a real Agent.
+    // Full agent config available — emit real Mastra instance
+    if (mastra.agentId && mastra.models.length > 0) {
+        const agentId = mastra.agentId;
+        return [
+            '/**',
+            ' * Mastra Studio entry point for `mastra dev` / `mastra build` / `mastra start`.',
+            ' *',
+            ' * Exports a configured Mastra instance with the project agent registered.',
+            ' */',
+            "import { Mastra } from '@mastra/core/mastra';",
+            "import { Agent } from '@mastra/core/agent';",
+            '',
+            '// @clint:begin mastra-index',
+            `const agent = new Agent({ id: '${agentId}', model: '${(mastra.models.find(m => m.isDefault) ?? mastra.models[0]).id}' });`,
+            '',
+            'export const mastra = new Mastra({',
+            `  agents: { '${agentId}': agent },`,
+            '});',
+            '// @clint:end mastra-index',
+            '',
+        ].join('\n');
+    }
+    // Mastra enabled but no full agent config yet — placeholder
     return [
         '/**',
         ' * Mastra Studio entry point for `mastra dev` / `mastra build` / `mastra start`.',

package/dist/codegen/index.js

@@ -35,7 +35,7 @@ import { hashContent, hashFile, readHashes, writeHashes, } from './hashes.js';
 import { hasMarkers, spliceMarkerRegions } from './markers.js';
 import { writeFileEnsuringDir, isDirEmptyEnough } from './write.js';
 import { migrateFlatToSplit } from './migrate/flat-to-split.js';
-import { CLI_FILE_BUILDERS, buildReadme, buildRootPackageJson, buildPublishConfigTs, buildAppIndexTs, } from './builders/index.js';
+import { CLI_FILE_BUILDERS, getProfileFileBuilders, buildReadme, buildRootPackageJson, buildPublishConfigTs, buildAppIndexTs, } from './builders/index.js';
 /**
  * Generate / reconcile a project at `targetDir` from the given spec.
  */
@@ -79,7 +79,8 @@ function planFiles(spec, targetDir) {
     const cliDir = split ? path.join(targetDir, getCliFolderName(spec)) : targetDir;
     const appDir = split ? path.join(targetDir, getAppFolderName(spec)) : null;
     const planned = [];
-    for (const builder of CLI_FILE_BUILDERS) {
+    const allBuilders = [...CLI_FILE_BUILDERS, ...getProfileFileBuilders(spec)];
+    for (const builder of allBuilders) {
         const content = builder.build(spec);
         if (content === null)
             continue;

package/dist/commands/clint-project-init.d.ts

@@ -38,6 +38,17 @@ export declare const init: import("@powerhousedao/ph-clint").Command<z.ZodObject
                 powerhouse: "Disabled" | "Reactor" | "Switchboard" | "Connect";
                 mastra: {
                     enabled: boolean;
+                    agentId: string | null;
+                    agentName: string | null;
+                    models: {
+                        id: string;
+                        isDefault: boolean;
+                    }[];
+                    profiles: {
+                        id: string;
+                        title: string;
+                        content: string;
+                    }[];
                 };
                 routine: {
                     enabled: boolean;

package/dist/commands/clint-project-init.js

@@ -73,13 +73,22 @@ export function buildSpec(input) {
     // Routine is forced on when Mastra is on — the REPL-only path works, but
     // the agent routine loop is what most users actually want.
     const routine = input.enableRoutine || input.enableMastra;
+    const mastra = input.enableMastra
+        ? {
+            enabled: true,
+            agentId: `${name}-agent`,
+            agentName: `${name.charAt(0).toUpperCase()}${name.slice(1).replace(/-(\w)/g, (_, c) => ' ' + c.toUpperCase())} Agent`,
+            models: [{ id: 'anthropic/claude-sonnet-4-5', isDefault: true }],
+            profiles: [{ id: 'base', title: 'Base', content: 'You are a helpful assistant.' }],
+        }
+        : { enabled: false };
     const candidate = {
         name,
         scope,
         description: input.description ?? '',
         features: {
             powerhouse: input.enablePowerhouse ? 'Connect' : 'Disabled',
-            mastra: { enabled: input.enableMastra },
+            mastra,
             routine: { enabled: routine },
         },
     };

package/dist/spec/types.d.ts

@@ -23,6 +23,17 @@ export declare const powerhouseLevelSchema: z.ZodDefault<z.ZodEnum<{
 export type PowerhouseLevel = z.infer<typeof powerhouseLevelSchema>;
 /** Check whether `level` is at least `threshold` in the ordered enum. */
 export declare function phAtLeast(level: PowerhouseLevel, threshold: PowerhouseLevel): boolean;
+export declare const agentModelSchema: z.ZodObject<{
+    id: z.ZodString;
+    isDefault: z.ZodBoolean;
+}, z.core.$strip>;
+export type AgentModel = z.infer<typeof agentModelSchema>;
+export declare const agentProfileSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    content: z.ZodString;
+}, z.core.$strip>;
+export type AgentProfile = z.infer<typeof agentProfileSchema>;
 export declare const powerhousePackageSchema: z.ZodObject<{
     id: z.ZodString;
     packageName: z.ZodString;
@@ -50,6 +61,17 @@ export declare const clintProjectSpecSchema: z.ZodObject<{
         }>>;
         mastra: z.ZodDefault<z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
+            agentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            agentName: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            models: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                isDefault: z.ZodBoolean;
+            }, z.core.$strip>>>;
+            profiles: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                content: z.ZodString;
+            }, z.core.$strip>>>;
         }, z.core.$strip>>;
         routine: z.ZodDefault<z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;

package/dist/spec/types.js

@@ -26,13 +26,32 @@ export const powerhouseLevelSchema = z
 export function phAtLeast(level, threshold) {
     return (POWERHOUSE_LEVELS.indexOf(level) >= POWERHOUSE_LEVELS.indexOf(threshold));
 }
+export const agentModelSchema = z.object({
+    id: z.string(),
+    isDefault: z.boolean(),
+});
+export const agentProfileSchema = z.object({
+    id: z.string(),
+    title: z.string(),
+    content: z.string(),
+});
 const mastraFeatureSchema = z.object({
     enabled: z.boolean().default(false),
+    agentId: z.string().nullable().default(null),
+    agentName: z.string().nullable().default(null),
+    models: z.array(agentModelSchema).default([]),
+    profiles: z.array(agentProfileSchema).default([]),
 });
 const routineFeatureSchema = z.object({
     enabled: z.boolean().default(false),
 });
-const DEFAULT_MASTRA = { enabled: false };
+const DEFAULT_MASTRA = {
+    enabled: false,
+    agentId: null,
+    agentName: null,
+    models: [],
+    profiles: [],
+};
 const DEFAULT_ROUTINE = { enabled: false };
 export const powerhousePackageSchema = z.object({
     id: z.string(),

package/dist/triggers/spec-change.js

@@ -86,6 +86,17 @@ export function specToImportInput(spec) {
         powerhouse: spec.features.powerhouse,
         mastraEnabled: spec.features.mastra.enabled,
         routineEnabled: spec.features.routine.enabled,
+        agentId: spec.features.mastra.agentId ?? null,
+        agentName: spec.features.mastra.agentName ?? null,
+        models: spec.features.mastra.models.map(m => ({
+            id: m.id,
+            isDefault: m.isDefault,
+        })),
+        profiles: spec.features.mastra.profiles.map(p => ({
+            id: p.id,
+            title: p.title,
+            content: p.content,
+        })),
         packages: spec.packages.map(p => ({
             id: p.id,
             packageName: p.packageName,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerhousedao/ph-clint-cli",
-  "version": "0.1.0-dev.22",
+  "version": "0.1.0-dev.23",
   "publishConfig": {
     "access": "public"
   },
@@ -28,9 +28,9 @@
     "@mastra/core": "^1.22.0",
     "@mastra/libsql": "^1.7.4",
     "@mastra/memory": "^1.13.1",
-    "@powerhousedao/ph-clint": "^0.1.0-dev.22",
-    "@powerhousedao/ph-clint-app": "^0.1.0-dev.22",
-    "@powerhousedao/ph-clint-dev": "^0.1.0-dev.22",
+    "@powerhousedao/ph-clint": "^0.1.0-dev.23",
+    "@powerhousedao/ph-clint-app": "^0.1.0-dev.23",
+    "@powerhousedao/ph-clint-dev": "^0.1.0-dev.23",
     "@powerhousedao/reactor": "6.0.0-dev.170",
     "@powerhousedao/reactor-api": "6.0.0-dev.170",
     "@powerhousedao/shared": "6.0.0-dev.170",