@powerhousedao/ph-clint-cli 0.1.0-dev.49 → 0.1.0-dev.50

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

@@ -12,7 +12,9 @@ function providerImport(provider) {
     }
 }
 function buildDemoAgent(spec) {
-    const id = spec.features.mastra.agentId ?? spec.name;
+    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';",
@@ -24,6 +26,7 @@ function buildDemoAgent(spec) {
         'function createDemoAgent(): AgentProvider {',
         '  return {',
         `    id: '${id}',`,
+        `    name: '${name}',`,
         '    async *stream(prompt) {',
         '      yield {',
         "        type: 'text-delta',",
@@ -99,6 +102,12 @@ function buildRealAgent(spec) {
     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('}');

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

@@ -49,9 +49,7 @@ function getPowerhouseVersion() {
 }
 export function buildCliPackageJson(spec) {
     const { mastra, powerhouse } = spec.features;
-    const pkgName = phAtLeast(powerhouse, 'Reactor')
-        ? `${getPackageName(spec)}-cli`
-        : getPackageName(spec);
+    const pkgName = getPackageName(spec);
     const bin = getBinName(spec);
     const dependencies = {
         '@powerhousedao/ph-clint': PH_CLINT_VERSION,

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

@@ -43,6 +43,9 @@ export function buildCliTs(spec) {
     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('');
     lines.push('export const cli = defineCli({');
@@ -66,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: [],');

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.js

@@ -4,6 +4,9 @@ export function buildDemoAgentTs(spec) {
     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';",
         '',
@@ -17,6 +20,9 @@ export function buildDemoAgentTs(spec) {
         '',
         '  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)) {',

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

@@ -4,16 +4,17 @@
  * Split-layout: a lockstep group with both app and cli packages.
  * Single-layout: a single-package group at `.`.
  */
-import { phAtLeast } from '../../spec/types.js';
+import { phAtLeast, getBinName, getAppFolderName, getCliFolderName, } from '../../spec/types.js';
 export function buildPublishConfigJs(spec) {
     const split = phAtLeast(spec.features.powerhouse, 'Reactor');
     // The publish pipeline appends the prerelease suffix (e.g. -dev.0), so we
     // only store the base semver (M.m.p) here.
     const baseVersion = spec.version.replace(/-.*$/, '');
+    const binName = getBinName(spec);
     const packages = split
         ? `[
-        { path: '${spec.name}-app', category: 'app' },
-        { path: '${spec.name}-cli', category: 'cli' },
+        { path: '${getAppFolderName(spec)}', category: 'app' },
+        { path: '${getCliFolderName(spec)}', category: 'cli' },
       ]`
         : `[
         { path: '.', category: 'cli' },
@@ -22,7 +23,7 @@ export function buildPublishConfigJs(spec) {
 // definePublishConfig is an identity function; a plain export is equivalent.
 export default {
   groups: {
-    '${spec.name}': {
+    '${binName}': {
       version: '${baseVersion}',
       packages: ${packages},
     },

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

@@ -6,10 +6,10 @@
  * Uses `pnpm --prefix <dir>` for all orchestration scripts — no cwd mutation.
  * Build order: app first, then cli (cli depends on app via `file:` dep).
  */
-import { getPackageName, phAtLeast, } from '../../spec/types.js';
+import { getAppFolderName, getBinName, getCliFolderName, phAtLeast, } from '../../spec/types.js';
 export function buildRootPackageJson(spec) {
-    const cli = `${spec.name}-cli`;
-    const app = `${spec.name}-app`;
+    const cli = getCliFolderName(spec);
+    const app = getAppFolderName(spec);
     const prefix = (dir, cmd) => `pnpm --prefix ${dir} ${cmd}`;
     const both = (cmd) => `${prefix(app, cmd)} && ${prefix(cli, cmd)}`;
     const connectEnabled = phAtLeast(spec.features.powerhouse, 'Connect');
@@ -28,7 +28,7 @@ export function buildRootPackageJson(spec) {
         'publish:production': `${prefix(cli, 'exec ph-publish')} production -c ../publish.config.js${connectEnabled ? ' --verify-connect' : ''}`,
     };
     const pkg = {
-        name: getPackageName(spec),
+        name: spec.scope ? `${spec.scope}/${getBinName(spec)}` : getBinName(spec),
         version: spec.version,
         private: true,
         type: 'module',

package/dist/codegen/scaffold.js

@@ -94,7 +94,7 @@ export async function runPhInit(options) {
 export async function patchAppPackageName(appDir, spec, log) {
     const appFolder = path.basename(appDir);
     const scopedName = spec.scope
-        ? `@${spec.scope}/${appFolder}`
+        ? `${spec.scope}/${appFolder}`
         : appFolder;
     const appPkgJsonPath = path.join(appDir, 'package.json');
     try {

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

@@ -49,6 +49,9 @@ export declare const init: import("@powerhousedao/ph-clint").Command<z.ZodObject
                         title: string;
                         content: string;
                     }[];
+                    common: {
+                        enableChat: boolean;
+                    };
                 };
                 routine: {
                     enabled: boolean;
@@ -58,6 +61,7 @@ export declare const init: import("@powerhousedao/ph-clint").Command<z.ZodObject
                 id: string;
                 packageName: string;
                 documentTypes: string[];
+                version: string | null;
             }[];
             externalSkills: {
                 id: string;
@@ -69,7 +73,6 @@ export declare const init: import("@powerhousedao/ph-clint").Command<z.ZodObject
                 supportedResources: string[];
             };
             scope?: string | undefined;
-            bin?: string | undefined;
             documentId?: string | undefined;
             documentType?: string | undefined;
         };

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

@@ -53,7 +53,7 @@ const inputSchema = z.object({
 function splitPackageName(raw) {
     const match = /^@([a-z0-9][a-z0-9-]*)\/([a-z0-9][a-z0-9-]*)$/.exec(raw);
     if (match)
-        return { scope: match[1], name: match[2] };
+        return { scope: `@${match[1]}`, name: match[2] };
     if (raw.startsWith('@')) {
         throw new Error(`invalid package name "${raw}" — expected "@scope/name" with lowercase letters, digits, hyphens`);
     }

package/dist/spec/from-document.js

@@ -9,30 +9,8 @@ export function specFromDocumentState(state, meta) {
     if (!state.name)
         return null;
     const parsed = clintProjectSpecSchema.safeParse({
-        name: state.name,
+        ...state,
         scope: state.scope ?? undefined,
-        version: state.version,
-        description: state.description,
-        bin: state.bin ?? undefined,
-        features: {
-            powerhouse: state.features.powerhouse,
-            mastra: { ...state.features.mastra },
-            routine: { ...state.features.routine },
-        },
-        packages: state.packages.map((p) => ({
-            id: p.id,
-            packageName: p.packageName,
-            documentTypes: [...p.documentTypes],
-        })),
-        externalSkills: state.externalSkills.map((s) => ({
-            id: s.id,
-            name: s.name,
-            githubUrl: s.githubUrl,
-        })),
-        deployment: {
-            proxyEnabled: state.deployment.proxyEnabled,
-            supportedResources: [...state.deployment.supportedResources],
-        },
         documentId: meta?.documentId,
         documentType: meta?.documentType,
     });

package/dist/spec/types.d.ts

@@ -38,6 +38,7 @@ export declare const powerhousePackageSchema: z.ZodObject<{
     id: z.ZodString;
     packageName: z.ZodString;
     documentTypes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    version: z.ZodDefault<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 export type PowerhousePackage = z.infer<typeof powerhousePackageSchema>;
 export declare const externalSkillSchema: z.ZodObject<{
@@ -51,7 +52,6 @@ export declare const clintProjectSpecSchema: z.ZodObject<{
     scope: z.ZodOptional<z.ZodString>;
     version: z.ZodDefault<z.ZodString>;
     description: z.ZodDefault<z.ZodString>;
-    bin: z.ZodOptional<z.ZodString>;
     features: z.ZodDefault<z.ZodObject<{
         powerhouse: z.ZodDefault<z.ZodEnum<{
             Disabled: "Disabled";
@@ -74,6 +74,9 @@ export declare const clintProjectSpecSchema: z.ZodObject<{
                 title: z.ZodString;
                 content: z.ZodString;
             }, z.core.$strip>>>;
+            common: z.ZodDefault<z.ZodObject<{
+                enableChat: z.ZodDefault<z.ZodBoolean>;
+            }, z.core.$strip>>;
         }, z.core.$strip>>;
         routine: z.ZodDefault<z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
@@ -83,6 +86,7 @@ export declare const clintProjectSpecSchema: z.ZodObject<{
         id: z.ZodString;
         packageName: z.ZodString;
         documentTypes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        version: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>>>;
     externalSkills: z.ZodDefault<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
@@ -98,9 +102,9 @@ export declare const clintProjectSpecSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type ClintProjectSpec = z.infer<typeof clintProjectSpecSchema>;
 export type ClintProjectSpecInput = z.input<typeof clintProjectSpecSchema>;
-/** npm package name (e.g. `@scope/foo` or `foo`). */
+/** npm package name (e.g. `@scope/my-tool-cli` or `my-tool-cli`). */
 export declare function getPackageName(spec: ClintProjectSpec): string;
-/** bin name (defaults to the bare project name). */
+/** bin name (strips -cli suffix, e.g. `my-tool-cli` → `my-tool`). */
 export declare function getBinName(spec: ClintProjectSpec): string;
 /**
  * Name of the CLI sub-folder when the project is split (Powerhouse enabled).
@@ -118,11 +122,11 @@ export declare function getAppFolderName(spec: ClintProjectSpec): string;
  */
 export declare function getAllDocumentTypes(spec: ClintProjectSpec): string[];
 /**
- * The app npm package name (`@scope/{name}-app` or `{name}-app`).
+ * The app npm package name (`@scope/my-tool-app` or `my-tool-app`).
  * Matches what the document model reducer stores in `packages[].packageName`.
  */
 export declare function getAppPackageName(spec: ClintProjectSpec): string;
-/** Directory name for the app package (`{name}-app`, no scope prefix). */
+/** Directory name for the app package (e.g. `my-tool-app`, no scope prefix). */
 export declare function getAppDirName(spec: ClintProjectSpec): string;
 /**
  * Folder slug for a documentType ID. The slug is the portion after the last

package/dist/spec/types.js

@@ -35,6 +35,9 @@ export const agentProfileSchema = z.object({
     title: z.string(),
     content: z.string(),
 });
+const mastraCommonSchema = z.object({
+    enableChat: z.boolean().default(false),
+});
 const mastraFeatureSchema = z.object({
     enabled: z.boolean().default(false),
     agentId: z.string().nullable().default(null),
@@ -43,6 +46,7 @@ const mastraFeatureSchema = z.object({
     agentImage: z.string().nullable().default(null),
     models: z.array(agentModelSchema).default([]),
     profiles: z.array(agentProfileSchema).default([]),
+    common: mastraCommonSchema.default({ enableChat: false }),
 });
 const routineFeatureSchema = z.object({
     enabled: z.boolean().default(false),
@@ -55,12 +59,14 @@ const DEFAULT_MASTRA = {
     agentImage: null,
     models: [],
     profiles: [],
+    common: { enableChat: false },
 };
 const DEFAULT_ROUTINE = { enabled: false };
 export const powerhousePackageSchema = z.object({
     id: z.string(),
     packageName: z.string(),
     documentTypes: z.array(z.string()).default([]),
+    version: z.string().nullable().default(null),
 });
 export const externalSkillSchema = z.object({
     id: z.string(),
@@ -70,14 +76,13 @@ export const externalSkillSchema = z.object({
 export const clintProjectSpecSchema = z.object({
     name: z
         .string()
-        .regex(/^[a-z0-9][a-z0-9-]*$/, 'lowercase letters, digits, hyphens only'),
+        .regex(/^[a-z0-9][a-z0-9-]*-cli$/, 'must end with -cli, lowercase letters, digits, hyphens only'),
     scope: z
         .string()
-        .regex(/^[a-z0-9][a-z0-9-]*$/, 'lowercase letters, digits, hyphens only')
+        .regex(/^@[a-z0-9][a-z0-9-]*$/, 'must start with @, lowercase letters, digits, hyphens only')
         .optional(),
     version: z.string().default('0.0.1-dev.0'),
     description: z.string().default(''),
-    bin: z.string().optional(),
     features: z
         .object({
         powerhouse: powerhouseLevelSchema,
@@ -111,26 +116,26 @@ export const clintProjectSpecSchema = z.object({
     /** Document type of the source specification document. */
     documentType: z.string().optional(),
 });
-/** npm package name (e.g. `@scope/foo` or `foo`). */
+/** npm package name (e.g. `@scope/my-tool-cli` or `my-tool-cli`). */
 export function getPackageName(spec) {
-    return spec.scope ? `@${spec.scope}/${spec.name}` : spec.name;
+    return spec.scope ? `${spec.scope}/${spec.name}` : spec.name;
 }
-/** bin name (defaults to the bare project name). */
+/** bin name (strips -cli suffix, e.g. `my-tool-cli` → `my-tool`). */
 export function getBinName(spec) {
-    return spec.bin ?? spec.name;
+    return spec.name.replace(/-cli$/, '');
 }
 /**
  * Name of the CLI sub-folder when the project is split (Powerhouse enabled).
  * For flat projects this is irrelevant — callers use the project root directly.
  */
 export function getCliFolderName(spec) {
-    return `${spec.name}-cli`;
+    return spec.name;
 }
 /**
  * Name of the reactor-package sub-folder when the project is split.
  */
 export function getAppFolderName(spec) {
-    return `${spec.name}-app`;
+    return spec.name.replace(/-cli$/, '-app');
 }
 /**
  * Flat list of all document types across all packages. Convenience for
@@ -141,16 +146,16 @@ export function getAllDocumentTypes(spec) {
     return spec.packages.flatMap((p) => p.documentTypes);
 }
 /**
- * The app npm package name (`@scope/{name}-app` or `{name}-app`).
+ * The app npm package name (`@scope/my-tool-app` or `my-tool-app`).
  * Matches what the document model reducer stores in `packages[].packageName`.
  */
 export function getAppPackageName(spec) {
-    const base = `${spec.name}-app`;
-    return spec.scope ? `@${spec.scope}/${base}` : base;
+    const base = getAppFolderName(spec);
+    return spec.scope ? `${spec.scope}/${base}` : base;
 }
-/** Directory name for the app package (`{name}-app`, no scope prefix). */
+/** Directory name for the app package (e.g. `my-tool-app`, no scope prefix). */
 export function getAppDirName(spec) {
-    return `${spec.name}-app`;
+    return getAppFolderName(spec);
 }
 /**
  * Folder slug for a documentType ID. The slug is the portion after the last

package/dist/triggers/spec-change.js

@@ -81,7 +81,6 @@ export function specToImportInput(spec) {
         scope: spec.scope ?? null,
         version: spec.version,
         description: spec.description,
-        bin: spec.bin ?? null,
         powerhouse: spec.features.powerhouse,
         mastraEnabled: spec.features.mastra.enabled,
         routineEnabled: spec.features.routine.enabled,

package/package.json

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