@soleri/forge 5.9.0 → 5.10.0

package/dist/templates/extensions.js

@@ -0,0 +1,89 @@
+/**
+ * Generate the extensions manifest (src/extensions/index.ts).
+ * This is the user's entry point for customization.
+ */
+export function generateExtensionsIndex(config) {
+    return `/**
+ * ${config.name} — Custom Extensions
+ *
+ * Add your custom ops, facades, middleware, and lifecycle hooks here.
+ * This file is auto-discovered by the agent entry point at startup.
+ *
+ * Core ops from @soleri/core are never modified — your extensions are
+ * additive (new ops, new facades) or decorative (middleware).
+ *
+ * See: https://soleri.dev/docs/extending
+ */
+
+import type { AgentExtensions, AgentRuntime } from '@soleri/core';
+
+// Import your custom ops, facades, and middleware here:
+// import { myCustomOp } from './ops/my-custom-op.js';
+// import { myFacade } from './facades/my-facade.js';
+// import { auditLogger } from './middleware/audit-logger.js';
+
+export default function loadExtensions(runtime: AgentRuntime): AgentExtensions {
+  return {
+    // ── Custom ops (merged into ${config.id}_core facade) ──────────
+    // ops: [
+    //   myCustomOp(runtime),
+    // ],
+
+    // ── Custom facades (registered as separate MCP tools) ──────────
+    // facades: [
+    //   myFacade(runtime),
+    // ],
+
+    // ── Middleware (wraps ALL ops across ALL facades) ───────────────
+    // middleware: [
+    //   auditLogger,
+    // ],
+
+    // ── Lifecycle hooks ────────────────────────────────────────────
+    // hooks: {
+    //   onStartup: async (rt) => {
+    //     console.error('[${config.id}] Custom startup logic');
+    //   },
+    //   onShutdown: async (rt) => {
+    //     console.error('[${config.id}] Custom shutdown logic');
+    //   },
+    // },
+  };
+}
+`;
+}
+/**
+ * Generate an example custom op file.
+ */
+export function generateExampleOp(config) {
+    return `/**
+ * Example custom op — add your own logic here.
+ *
+ * Custom ops are merged into the ${config.id}_core facade alongside
+ * the built-in ops from @soleri/core. They have full access
+ * to the agent runtime (vault, brain, planner, etc.).
+ */
+
+import { z } from 'zod';
+import type { OpDefinition, AgentRuntime } from '@soleri/core';
+
+export function createExampleOp(runtime: AgentRuntime): OpDefinition {
+  return {
+    name: 'example',
+    description: 'Example custom op — replace with your own logic.',
+    auth: 'read',
+    schema: z.object({
+      message: z.string().optional().describe('Optional message'),
+    }),
+    handler: async (params) => {
+      const stats = runtime.vault.stats();
+      return {
+        message: params.message ?? 'Hello from custom extension!',
+        vaultEntries: stats.totalEntries,
+      };
+    },
+  };
+}
+`;
+}
+//# sourceMappingURL=extensions.js.map

package/dist/templates/extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.js","sourceRoot":"","sources":["../../src/templates/extensions.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAmB;IACzD,OAAO;KACJ,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;oCAoBoB,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;6BAkBhB,MAAM,CAAC,EAAE;;;6BAGT,MAAM,CAAC,EAAE;;;;;CAKrC,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAmB;IACnD,OAAO;;;oCAG2B,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;CAyB5C,CAAC;AACF,CAAC"}

package/dist/templates/persona.js

@@ -1,10 +1,12 @@
 export function generatePersona(config) {
     const principleLines = config.principles.map((p) => `    '${escapeQuotes(p)}',`).join('\n');
+    const tone = config.tone ?? 'pragmatic';
     return `export interface AgentPersona {
   name: string;
   role: string;
   description: string;
   principles: string[];
+  tone: 'precise' | 'mentor' | 'pragmatic';
   greeting: string;
 }
 
@@ -15,10 +17,33 @@ export const PERSONA: AgentPersona = {
   principles: [
 ${principleLines}
   ],
+  tone: '${tone}',
   greeting: '${escapeQuotes(config.greeting ?? `Hello! I'm ${config.name}.`)}',
 };
 
+const TONE_INSTRUCTIONS: Record<string, string[]> = {
+  precise: [
+    'Communication style: precise',
+    '- Be direct and factual with minimal commentary',
+    '- Lead with the conclusion, then support it',
+    '- Omit caveats unless they change the recommendation',
+  ],
+  mentor: [
+    'Communication style: mentor',
+    '- Explain the "why" behind every suggestion',
+    '- Use examples to illustrate concepts',
+    '- Guide the user to understand, not just follow instructions',
+  ],
+  pragmatic: [
+    'Communication style: pragmatic',
+    '- Focus on actionable outcomes',
+    '- Balance thoroughness with brevity',
+    '- Prioritize what matters most for the current context',
+  ],
+};
+
 export function getPersonaPrompt(): string {
+  const toneLines = TONE_INSTRUCTIONS[PERSONA.tone] ?? TONE_INSTRUCTIONS.pragmatic;
   return [
     \`You are \${PERSONA.name}, a \${PERSONA.role}.\`,
     '',
@@ -27,6 +52,8 @@ export function getPersonaPrompt(): string {
     'Core principles:',
     ...PERSONA.principles.map((p) => \`- \${p}\`),
     '',
+    ...toneLines,
+    '',
     'When advising:',
     '- Reference specific patterns from the knowledge vault',
     '- Provide concrete examples, not just theory',

package/dist/templates/persona.js.map

@@ -1 +1 @@
-{"version":3,"file":"persona.js","sourceRoot":"","sources":["../../src/templates/persona.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,eAAe,CAAC,MAAmB;IACjD,MAAM,cAAc,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE5F,OAAO;;;;;;;;;WASE,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;WACzB,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;kBAClB,YAAY,CAAC,MAAM,CAAC,WAAW,CAAC;;EAEhD,cAAc;;eAED,YAAY,CAAC,MAAM,CAAC,QAAQ,IAAI,cAAc,MAAM,CAAC,IAAI,GAAG,CAAC;;;;;;;;;;;;;;;;;;;CAmB3E,CAAC;AACF,CAAC;AAED,SAAS,YAAY,CAAC,CAAS;IAC7B,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACvD,CAAC"}
+{"version":3,"file":"persona.js","sourceRoot":"","sources":["../../src/templates/persona.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,eAAe,CAAC,MAAmB;IACjD,MAAM,cAAc,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5F,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,WAAW,CAAC;IAExC,OAAO;;;;;;;;;;WAUE,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;WACzB,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;kBAClB,YAAY,CAAC,MAAM,CAAC,WAAW,CAAC;;EAEhD,cAAc;;WAEL,IAAI;eACA,YAAY,CAAC,MAAM,CAAC,QAAQ,IAAI,cAAc,MAAM,CAAC,IAAI,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2C3E,CAAC;AACF,CAAC;AAED,SAAS,YAAY,CAAC,CAAS;IAC7B,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACvD,CAAC"}

package/dist/templates/skills.d.ts

@@ -3,6 +3,8 @@ import type { AgentConfig } from '../types.js';
  * Generate skill files for the scaffolded agent.
  * Returns [relativePath, content] tuples for each skill.
  *
+ * - If config.skills is set, only those skills are included.
+ * - If config.skills is undefined/empty, all skills are included (backward compat).
  * - Superpowers-adapted skills (MIT): copied as-is
  * - Engine-adapted skills: YOUR_AGENT_core → {config.id}_core
  */

package/dist/templates/skills.js

@@ -27,6 +27,8 @@ const AGENT_SPECIFIC_SKILLS = new Set([
  * Generate skill files for the scaffolded agent.
  * Returns [relativePath, content] tuples for each skill.
  *
+ * - If config.skills is set, only those skills are included.
+ * - If config.skills is undefined/empty, all skills are included (backward compat).
  * - Superpowers-adapted skills (MIT): copied as-is
  * - Engine-adapted skills: YOUR_AGENT_core → {config.id}_core
  */
@@ -39,8 +41,16 @@ export function generateSkills(config) {
     catch {
         return files;
     }
+    // If skills array is present, filter to only those skills.
+    // undefined = include all (backward compat), [] = include none.
+    const allowedSkills = config.skills
+        ? new Set(config.skills)
+        : null; // null = include all (backward compat)
     for (const file of skillFiles) {
         const skillName = file.replace('.md', '');
+        if (allowedSkills && !allowedSkills.has(skillName)) {
+            continue;
+        }
         let content = readFileSync(join(SKILLS_DIR, file), 'utf-8');
         if (AGENT_SPECIFIC_SKILLS.has(skillName)) {
             content = content.replace(/YOUR_AGENT_core/g, `${config.id}_core`);

package/dist/templates/skills.js.map

@@ -1 +1 @@
-{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/templates/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;AAEnD,wFAAwF;AACxF,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC;IACpC,eAAe;IACf,eAAe;IACf,aAAa;IACb,gBAAgB;IAChB,iBAAiB;IACjB,eAAe;IACf,cAAc;IACd,mBAAmB;IACnB,YAAY;IACZ,eAAe;IACf,gBAAgB;IAChB,sBAAsB;IACtB,yBAAyB;IACzB,eAAe;IACf,iBAAiB;IACjB,gCAAgC;IAChC,eAAe;CAChB,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,MAAmB;IAChD,MAAM,KAAK,GAA4B,EAAE,CAAC;IAC1C,IAAI,UAAoB,CAAC;IAEzB,IAAI,CAAC;QACH,UAAU,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC1C,IAAI,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QAE5D,IAAI,qBAAqB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACzC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;QACrE,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,CAAC,UAAU,SAAS,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,IAAI,UAAoB,CAAC;IAEzB,IAAI,CAAC;QACH,UAAU,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAC7B,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QAC9D,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACnD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAClE,OAAO;YACL,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;YACvD,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE;SAC1C,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/templates/skills.ts"],"names":[],"mappings":"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"}