@ariaflowagents/config 0.5.3 → 0.8.0

package/README.md

@@ -311,14 +311,49 @@ Define reusable workflow patterns:
 {
   "flows": {
     "booking-flow": {
-      "steps": [
+      "entry": "start",
+      "defaultRolePrompt": "You are a booking assistant.",
+      "nodes": [
         {
-          "id": "collect-info",
-          "tool": "collect_info"
+          "id": "start",
+          "nodeType": "start",
+          "addGlobalPrompt": true,
+          "prompt": "Welcome. What date would you like to book?"
         },
         {
-          "id": "confirm",
-          "tool": "confirm_booking"
+          "id": "collect_time",
+          "nodeType": "agent",
+          "prompt": "What time works for you?"
+        },
+        {
+          "id": "end_call",
+          "nodeType": "end",
+          "addGlobalPrompt": false,
+          "prompt": "Thanks, your booking is complete."
+        }
+      ],
+      "transitions": [
+        {
+          "from": "start",
+          "to": "collect_time",
+          "on": "to_collect_time",
+          "contract": {
+            "label": "Move to collect time",
+            "conditionText": "After user provides a valid date.",
+            "toolOnly": true,
+            "requiresUserTurn": true
+          }
+        },
+        {
+          "from": "collect_time",
+          "to": "end_call",
+          "on": "to_end_call",
+          "contract": {
+            "label": "Finish booking",
+            "conditionText": "After user confirms final booking details.",
+            "toolOnly": true,
+            "requiresUserTurn": true
+          }
         }
       ]
     }
@@ -326,6 +361,44 @@ Define reusable workflow patterns:
 }
 ```
 
+Flow validation is enforced at load time:
+- `nodes` must exist and have unique ids
+- node prompts must be non-empty
+- transition `from`/`to` must reference existing nodes
+- transition must define `on` or `condition`
+- at most one `nodeType: "start"` and one `nodeType: "global"`
+
+### Generate a Flow Scaffold (CLI)
+
+```bash
+ariaflow flow generate --use-case "medical appointment scheduling" --out ./.ariaflow/flow/appointments.json
+```
+
+Useful options:
+- `--id <flow-id>`
+- `--direction inbound|outbound`
+- `--agent-name <name>`
+- `--llm` (enable model-authored prompts)
+- `--model <id>` (default: `gpt-5-mini`; OpenAI models such as `gpt-5-mini`, `gpt-4.1`, or `openai:gpt-4.1`)
+- `--llm-mode hybrid|full` (default: `hybrid`)
+- `--context-file <path>` (YAML/MD/TXT domain context)
+- `--timeout-ms <n>`
+- `--out-ts <path>` (emit typed TypeScript flow module for code-first agents)
+- `--ts-const <name>` (const name in emitted TS module)
+- `--force`
+
+Hybrid mode behavior:
+- Static sections remain fixed (structure, critical rules, transitions).
+- Only domain-specific blocks vary (overall use-case details and main-agenda tasks/questions).
+- This keeps outputs closer to production templates while still adapting per use case.
+
+Code-first usage:
+- Use `--out-ts` to generate a typed `FlowConfig` module you can import directly in TypeScript agents.
+- This keeps generator output use-case agnostic and reusable across config-first and code-first paths.
+
+LLM provider env var:
+- OpenAI models require `OPENAI_API_KEY`
+
 ## Providers
 
 Configure API providers:
@@ -481,6 +554,7 @@ my-agent/
 | `runtime` | object | Yes | Runtime configuration |
 | `models` | object | Yes | Model registry |
 | `agents` | object | Yes | Agent definitions |
+| `flows` | object | No | Reusable flow definitions (`nodes` + `transitions`) |
 | `tools` | object | No | Tool definitions |
 | `providers` | object | No | Provider configurations |
 | `permissions` | object | No | Permission settings |
@@ -505,6 +579,20 @@ my-agent/
 | `flowRef` | string | Flow reference (flow only) |
 | `mode` | string | Flow mode: `guided`, `hybrid` (flow only) |
 
+### Flow Properties
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `entry` / `initialNode` | string | Initial node id |
+| `defaultRolePrompt` | string | Global flow prompt applied to nodes by default |
+| `nodes` | array | Flow nodes (`id`, `prompt`, optional `nodeType`, `addGlobalPrompt`) |
+| `transitions` | array | Edges (`from`, `to`, `on`/`condition`, optional `contract`) |
+| `contextStrategy` | string | `append`, `reset`, `reset_with_summary` |
+| `summaryPrompt` | string | Prompt used when summarizing context |
+| `summaryMaxTokens` | number | Max tokens for summary generation |
+| `summaryTimeoutMs` | number | Summary timeout guardrail |
+| `maxSteps` | number | Default max tool-call steps in stream loop |
+
 ### Prompt Properties
 
 | Property | Type | Description |

package/dist/agent-architect/index.d.ts

@@ -0,0 +1,10 @@
+import { type ArchitectOptions, type ArchitectResult, type AgentMode, type DomainAnalysis, type ToolRecommendation, type SixLayerPrompt, type DetailLevel } from './types.js';
+export interface RunArchitectOptions extends ArchitectOptions {
+    model?: string;
+    timeoutMs?: number;
+    mode?: AgentMode;
+    detailLevel?: DetailLevel;
+}
+export declare function runArchitect(options: RunArchitectOptions): Promise<ArchitectResult>;
+export { type DomainAnalysis, type ToolRecommendation, type SixLayerPrompt };
+//# sourceMappingURL=index.d.ts.map

package/dist/agent-architect/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent-architect/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,WAAW,EAEjB,MAAM,YAAY,CAAC;AA4BpB,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,eAAe,CAAC,CA+H1B;AAED,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,kBAAkB,EAAE,KAAK,cAAc,EAAE,CAAC"}

package/dist/agent-architect/index.js

@@ -0,0 +1,131 @@
+import { analyzeUseCase } from './use-case-analyzer.js';
+import { recommendTools, getToolPolicy } from './tool-recommender.js';
+import { generateSixLayerPrompt, renderSixLayerPromptAsMarkdown, renderSixLayerPromptAsTypeScript } from './prompt-generator.js';
+import { generateRfcMarkdown } from './rfc-emitter.js';
+import { generateFlowTemplateWithLLM } from '../llm-flow-generator.js';
+import { emitFlowTypeScriptModule } from '../flow-codegen.js';
+import { AgentBlueprintSchema, } from './types.js';
+function toSlug(value) {
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 64) || 'generated-agent';
+}
+function toTitleCase(value) {
+    return value
+        .replace(/[_-]+/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim()
+        .split(' ')
+        .map(word => (word ? word[0].toUpperCase() + word.slice(1) : ''))
+        .join(' ');
+}
+function toTsConstCase(value) {
+    const clean = value.replace(/[^a-zA-Z0-9]+/g, ' ').trim();
+    const words = clean.split(/\s+/).filter(Boolean);
+    if (words.length === 0)
+        return 'generatedAgent';
+    const [head, ...tail] = words;
+    return `${head.toLowerCase()}${tail.map(word => word[0].toUpperCase() + word.slice(1).toLowerCase()).join('')}`;
+}
+export async function runArchitect(options) {
+    const { useCase, mode = 'hybrid', target = 'both', name, model, contextText, timeoutMs = 120000, detailLevel = 'detailed', } = options;
+    console.log('\n🔍 Analyzing use case with LLM...');
+    const domainAnalysis = await analyzeUseCase(useCase, {
+        model,
+        contextText,
+        timeoutMs,
+    });
+    console.log('   Domain:', domainAnalysis.domain);
+    console.log('   Entities:', domainAnalysis.entities.join(', '));
+    console.log('   Workflows:', domainAnalysis.workflows.join(', '));
+    console.log('\n🛠️  Recommending tools with LLM...');
+    const toolRecommendations = await recommendTools(useCase, domainAnalysis, {
+        model,
+        timeoutMs,
+    });
+    console.log('   Recommended tools:');
+    for (const tool of toolRecommendations) {
+        console.log(`   - ${tool.toolName} (${tool.priority})`);
+    }
+    const blueprintId = toSlug(name ?? useCase);
+    const displayName = name ? toTitleCase(name) : toTitleCase(blueprintId);
+    console.log('\n📝 Generating 6-layer prompt with LLM...');
+    const promptLayers = await generateSixLayerPrompt(displayName, useCase, domainAnalysis, toolRecommendations, mode, { model, timeoutMs });
+    let flowJson;
+    let flowTs;
+    if (mode !== 'llm') {
+        console.log('\n🔀 Generating flow for ' + mode + ' mode...');
+        try {
+            flowJson = await generateFlowTemplateWithLLM({
+                useCase,
+                direction: 'inbound',
+                agentName: displayName,
+                model: model ?? 'gpt-5-mini',
+                llmMode: mode === 'flow' ? 'full' : 'hybrid',
+                contextText,
+                timeoutMs,
+            });
+            console.log('   Flow nodes:', flowJson?.nodes?.length ?? 0);
+            if (target === 'code' || target === 'both') {
+                flowTs = emitFlowTypeScriptModule(flowJson, { constName: `${toTsConstCase(blueprintId)}Flow` });
+            }
+        }
+        catch (error) {
+            console.warn('   Flow generation failed, continuing without flow:', error);
+        }
+    }
+    const blueprint = {
+        id: blueprintId,
+        name: displayName,
+        useCase,
+        mode,
+        target,
+        domainAnalysis: {
+            ...domainAnalysis,
+            constraints: domainAnalysis.constraints ?? [],
+        },
+        selectedTools: toolRecommendations.map(t => t.toolName),
+        toolRecommendations,
+        toolPolicy: getToolPolicy(toolRecommendations),
+        promptLayers,
+        evalPlan: {
+            scenarios: [
+                'happy_path_conversation',
+                'tool_failure_recovery',
+                'invalid_user_input',
+                'policy_refusal',
+                'edge_case_handling',
+            ],
+        },
+        generationMeta: {
+            generatedAt: new Date().toISOString(),
+            model: model ?? 'gpt-5-mini',
+            llmRequired: true,
+            llmEnabled: true,
+            llmMode: mode,
+            interactive: options.interactive ?? false,
+            clarificationCount: 0,
+            clarifications: [],
+        },
+    };
+    const promptMarkdown = renderSixLayerPromptAsMarkdown(displayName, promptLayers);
+    const promptConstName = toTsConstCase(blueprintId);
+    const promptTypeScript = renderSixLayerPromptAsTypeScript(promptConstName, promptLayers);
+    const artifacts = {
+        prompt: promptMarkdown,
+        flow: flowJson,
+        code: {
+            prompt: promptTypeScript,
+            flow: flowTs,
+        },
+    };
+    const rfcMarkdown = generateRfcMarkdown(blueprint, artifacts, detailLevel);
+    artifacts.rfc = rfcMarkdown;
+    return {
+        blueprint: AgentBlueprintSchema.parse(blueprint),
+        artifacts,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/agent-architect/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent-architect/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAA+B,MAAM,wBAAwB,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,aAAa,EAA+B,MAAM,uBAAuB,CAAC;AACnG,OAAO,EAAE,sBAAsB,EAAE,8BAA8B,EAAE,gCAAgC,EAA+B,MAAM,uBAAuB,CAAC;AAC9J,OAAO,EAAE,mBAAmB,EAA8B,MAAM,kBAAkB,CAAC;AACnF,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EASL,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,SAAS,MAAM,CAAC,KAAa;IAC3B,OAAO,KAAK;SACT,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,iBAAiB,CAAC;AACvC,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,KAAK;SACT,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE;SACN,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SACjE,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IAClC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1D,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,gBAAgB,CAAC;IAChD,MAAM,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC;IAC9B,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;AACnH,CAAC;AASD,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAA4B;IAE5B,MAAM,EACJ,OAAO,EACP,IAAI,GAAG,QAAQ,EACf,MAAM,GAAG,MAAM,EACf,IAAI,EACJ,KAAK,EACL,WAAW,EACX,SAAS,GAAG,MAAM,EAClB,WAAW,GAAG,UAAU,GACzB,GAAG,OAAO,CAAC;IAEZ,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;IACnD,MAAM,cAAc,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE;QACnD,KAAK;QACL,WAAW;QACX,SAAS;KACV,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IACjD,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAChE,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAElE,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;IACrD,MAAM,mBAAmB,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,cAAc,EAAE;QACxE,KAAK;QACL,SAAS;KACV,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IACrC,KAAK,MAAM,IAAI,IAAI,mBAAmB,EAAE,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IAExE,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;IAC1D,MAAM,YAAY,GAAG,MAAM,sBAAsB,CAC/C,WAAW,EACX,OAAO,EACP,cAAc,EACd,mBAAmB,EACnB,IAAI,EACJ,EAAE,KAAK,EAAE,SAAS,EAAE,CACrB,CAAC;IAEF,IAAI,QAA4B,CAAC;IACjC,IAAI,MAA0B,CAAC;IAE/B,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,2BAA2B,GAAG,IAAI,GAAG,UAAU,CAAC,CAAC;QAC7D,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,2BAA2B,CAAC;gBAC3C,OAAO;gBACP,SAAS,EAAE,SAAS;gBACpB,SAAS,EAAE,WAAW;gBACtB,KAAK,EAAE,KAAK,IAAI,YAAY;gBAC5B,OAAO,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;gBAC5C,WAAW;gBACX,SAAS;aACV,CAAC,CAAC;YACH,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAG,QAAgB,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;YAErE,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;gBAC3C,MAAM,GAAG,wBAAwB,CAAC,QAAe,EAAE,EAAE,SAAS,EAAE,GAAG,aAAa,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;YACzG,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,qDAAqD,EAAE,KAAK,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG;QAChB,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,WAAW;QACjB,OAAO;QACP,IAAI;QACJ,MAAM;QACN,cAAc,EAAE;YACd,GAAG,cAAc;YACjB,WAAW,EAAE,cAAc,CAAC,WAAW,IAAI,EAAE;SACvC;QACR,aAAa,EAAE,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;QACvD,mBAAmB;QACnB,UAAU,EAAE,aAAa,CAAC,mBAAmB,CAAC;QAC9C,YAAY;QACZ,QAAQ,EAAE;YACR,SAAS,EAAE;gBACT,yBAAyB;gBACzB,uBAAuB;gBACvB,oBAAoB;gBACpB,gBAAgB;gBAChB,oBAAoB;aACrB;SACF;QACD,cAAc,EAAE;YACd,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACrC,KAAK,EAAE,KAAK,IAAI,YAAY;YAC5B,WAAW,EAAE,IAAI;YACjB,UAAU,EAAE,IAAI;YAChB,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,KAAK;YACzC,kBAAkB,EAAE,CAAC;YACrB,cAAc,EAAE,EAAE;SACnB;KACF,CAAC;IAEF,MAAM,cAAc,GAAG,8BAA8B,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IACjF,MAAM,eAAe,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IACnD,MAAM,gBAAgB,GAAG,gCAAgC,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;IAEzF,MAAM,SAAS,GAAiC;QAC9C,MAAM,EAAE,cAAc;QACtB,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE;YACJ,MAAM,EAAE,gBAAgB;YACxB,IAAI,EAAE,MAAM;SACb;KACF,CAAC;IAEF,MAAM,WAAW,GAAG,mBAAmB,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IAC3E,SAAS,CAAC,GAAG,GAAG,WAAW,CAAC;IAE5B,OAAO;QACL,SAAS,EAAE,oBAAoB,CAAC,KAAK,CAAC,SAAS,CAAC;QAChD,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/agent-architect/prompt-generator.d.ts

@@ -0,0 +1,9 @@
+import { type DomainAnalysis, type ToolRecommendation, type SixLayerPrompt } from './types.js';
+export interface PromptGeneratorOptions {
+    model?: string;
+    timeoutMs?: number;
+}
+export declare function generateSixLayerPrompt(agentName: string, useCase: string, domainAnalysis: DomainAnalysis, toolRecommendations: ToolRecommendation[], mode: 'llm' | 'flow' | 'hybrid', options?: PromptGeneratorOptions): Promise<SixLayerPrompt>;
+export declare function renderSixLayerPromptAsMarkdown(agentName: string, prompt: SixLayerPrompt): string;
+export declare function renderSixLayerPromptAsTypeScript(constName: string, prompt: SixLayerPrompt): string;
+//# sourceMappingURL=prompt-generator.d.ts.map

package/dist/agent-architect/prompt-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-generator.d.ts","sourceRoot":"","sources":["../../src/agent-architect/prompt-generator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,kBAAkB,EAAE,KAAK,cAAc,EAAwB,MAAM,YAAY,CAAC;AAqGrH,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,cAAc,EAC9B,mBAAmB,EAAE,kBAAkB,EAAE,EACzC,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,EAC/B,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,cAAc,CAAC,CA8BzB;AAED,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,cAAc,GACrB,MAAM,CA6BR;AAED,wBAAgB,gCAAgC,CAC9C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,cAAc,GACrB,MAAM,CAMR"}

package/dist/agent-architect/prompt-generator.js

@@ -0,0 +1,155 @@
+import { generateObject } from 'ai';
+import { openai } from '@ai-sdk/openai';
+import { z } from 'zod';
+import { SixLayerPromptSchema } from './types.js';
+const SixLayerPromptLLMSchema = z.object({
+    identityAndRole: z.object({
+        name: z.string().describe('Layer identifier'),
+        content: z.string().describe('The actual prompt text for this layer'),
+        purpose: z.string().describe('Why this layer exists'),
+    }),
+    safetyAndGuardrails: z.object({
+        name: z.string().describe('Layer identifier'),
+        content: z.string().describe('The actual prompt text for this layer'),
+        purpose: z.string().describe('Why this layer exists'),
+    }),
+    toolContract: z.object({
+        name: z.string().describe('Layer identifier'),
+        content: z.string().describe('The actual prompt text for this layer'),
+        purpose: z.string().describe('Why this layer exists'),
+    }),
+    reasoningWorkflow: z.object({
+        name: z.string().describe('Layer identifier'),
+        content: z.string().describe('The actual prompt text for this layer'),
+        purpose: z.string().describe('Why this layer exists'),
+    }),
+    executionPolicy: z.object({
+        name: z.string().describe('Layer identifier'),
+        content: z.string().describe('The actual prompt text for this layer'),
+        purpose: z.string().describe('Why this layer exists'),
+    }),
+    outputConstraints: z.object({
+        name: z.string().describe('Layer identifier'),
+        content: z.string().describe('The actual prompt text for this layer'),
+        purpose: z.string().describe('Why this layer exists'),
+    }),
+});
+function resolveModel(modelInput) {
+    const requested = modelInput?.trim() || 'gpt-5-mini';
+    const modelId = requested.startsWith('openai:') ? requested.slice('openai:'.length).trim() : requested;
+    return openai(modelId || 'gpt-5-mini');
+}
+function buildPromptGenerationPrompt(agentName, useCase, domainAnalysis, toolRecommendations, mode) {
+    const toolsList = toolRecommendations.map(t => `- ${t.toolName}: ${t.description} (${t.priority})`).join('\n');
+    return `Generate a 6-layer system prompt for a conversational AI agent.
+
+## Agent Identity
+- Name: ${agentName}
+- Use Case: ${useCase}
+
+## Domain Analysis
+- Domain: ${domainAnalysis.domain}
+${domainAnalysis.subDomain ? `- Sub-domain: ${domainAnalysis.subDomain}` : ''}
+- Entities: ${domainAnalysis.entities.join(', ')}
+- Workflows: ${domainAnalysis.workflows.join(', ')}
+- User Intents: ${domainAnalysis.userIntents.join(', ')}
+- Key Outcomes: ${domainAnalysis.keyOutcomes.join(', ')}
+
+## Recommended Tools
+${toolsList}
+
+## Agent Mode
+${mode === 'llm' ? 'Pure LLM agent - uses tools but no structured flow' : mode === 'flow' ? 'Flow-based agent - follows structured conversation flow' : 'Hybrid agent - flow with LLM detours'}
+
+## Your Task
+Generate each of the 6 prompt layers:
+
+### Layer 1: Identity and Role
+Who is the agent? What is its purpose? What tone should it use?
+
+### Layer 2: Safety and Guardrails
+What should the agent NEVER do? What are the safety constraints? When should it escalate?
+
+### Layer 3: Tool Contract
+What tools are available? When should each be used? What happens on tool failure?
+
+### Layer 4: Reasoning Workflow
+How should the agent think through conversations? What questions to ask? In what order?
+
+### Layer 5: Execution Policy
+How does the agent behave in ${mode} mode? What are the rules for tool calls vs user messages?
+
+### Layer 6: Output Constraints
+How should responses be formatted? What verification steps before final actions?
+
+For each layer, provide:
+- name: Layer identifier
+- content: The actual prompt text
+- purpose: Why this layer exists
+
+Make the prompts specific to this use case, not generic templates.`;
+}
+export async function generateSixLayerPrompt(agentName, useCase, domainAnalysis, toolRecommendations, mode, options = {}) {
+    const model = resolveModel(options.model);
+    const timeoutMs = options.timeoutMs ?? 60000;
+    if (!process.env.OPENAI_API_KEY) {
+        throw new Error('OPENAI_API_KEY is required for LLM prompt generation');
+    }
+    const result = await Promise.race([
+        generateObject({
+            model,
+            schema: SixLayerPromptLLMSchema,
+            system: `You are an expert prompt engineer for conversational AI agents.
+Generate 6-layer system prompts based on the OpenAI-inspired context model:
+1. Identity and Role
+2. Safety and Guardrails
+3. Tool Contract
+4. Reasoning Workflow
+5. Execution Policy
+6. Output Constraints
+
+Each layer should be specific to the use case, not generic.`,
+            prompt: buildPromptGenerationPrompt(agentName, useCase, domainAnalysis, toolRecommendations, mode),
+        }),
+        new Promise((_, reject) => setTimeout(() => reject(new Error(`Prompt generation timed out after ${timeoutMs}ms`)), timeoutMs)),
+    ]);
+    return SixLayerPromptSchema.parse(result.object);
+}
+export function renderSixLayerPromptAsMarkdown(agentName, prompt) {
+    return [
+        `# ${agentName} System Prompt`,
+        '',
+        `## 1. Identity and Role`,
+        '',
+        prompt.identityAndRole.content,
+        '',
+        `## 2. Safety and Guardrails`,
+        '',
+        prompt.safetyAndGuardrails.content,
+        '',
+        `## 3. Tool Contract`,
+        '',
+        prompt.toolContract.content,
+        '',
+        `## 4. Reasoning Workflow`,
+        '',
+        prompt.reasoningWorkflow.content,
+        '',
+        `## 5. Execution Policy`,
+        '',
+        prompt.executionPolicy.content,
+        '',
+        `## 6. Output Constraints`,
+        '',
+        prompt.outputConstraints.content,
+        '',
+    ].join('\n');
+}
+export function renderSixLayerPromptAsTypeScript(constName, prompt) {
+    const serialized = JSON.stringify(prompt, null, 2);
+    return `export const ${constName}SystemPrompt = ${serialized} as const;
+
+export default ${constName}SystemPrompt;
+`;
+}
+//# sourceMappingURL=prompt-generator.js.map

package/dist/agent-architect/prompt-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-generator.js","sourceRoot":"","sources":["../../src/agent-architect/prompt-generator.ts"],"names":[],"mappings":"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"}

package/dist/agent-architect/rfc-emitter.d.ts

@@ -0,0 +1,18 @@
+import { type AgentBlueprint, type DetailLevel } from './types.js';
+export declare function generateRfcMarkdown(blueprint: AgentBlueprint, artifacts: {
+    prompt?: string;
+    flow?: object;
+}, detailLevel?: DetailLevel): string;
+export declare function generateToolSpecifications(recommendations: {
+    toolName: string;
+    description: string;
+    whenToUse: string;
+    onError?: string;
+}[]): Array<{
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    outputSchema: Record<string, unknown>;
+    integrationSteps: string[];
+}>;
+//# sourceMappingURL=rfc-emitter.d.ts.map

package/dist/agent-architect/rfc-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rfc-emitter.d.ts","sourceRoot":"","sources":["../../src/agent-architect/rfc-emitter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAgHnE,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,cAAc,EACzB,SAAS,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAC7C,WAAW,GAAE,WAAwB,GACpC,MAAM,CAmIR;AAED,wBAAgB,0BAA0B,CACxC,eAAe,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,GAChG,KAAK,CAAC;IACP,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B,CAAC,CAQD"}