the-citadel 0.4.1 → 0.4.3

package/dist/{src/core → core}/beads.d.ts

@@ -64,6 +64,7 @@ export declare class BeadsClient {
     update(id: string, changes: Partial<Bead>): Promise<Bead>;
     private validateTransition;
     addDependency(childId: string, parentId: string): Promise<void>;
+    addComment(id: string, comment: string): Promise<string>;
 }
 export declare function getBeads(basePath?: string): BeadsClient;
 export declare function setBeadsInstance(beads: BeadsClient): void;

package/dist/index.js

@@ -84440,7 +84440,7 @@ class BeadsClient {
     this.binary = binary2 || config2?.beads.binary || "bd";
   }
   async runCommand(args, retryCount = 0) {
-    const command = `${this.binary} --sandbox ${args}`;
+    const command = `${this.binary} --sandbox --no-db ${args}`;
     const cwd2 = this.basePath.endsWith(".beads") ? resolve5(this.basePath, "..") : this.basePath;
     try {
       const { stdout, stderr } = await this.execute(command, cwd2);
@@ -84718,6 +84718,10 @@ ${descText}`;
   async addDependency(childId, parentId) {
     await this.runCommand(`dep add ${childId} ${parentId}`);
   }
+  async addComment(id, comment) {
+    const escaped = comment.replace(/"/g, "\\\"");
+    return this.runCommand(`comments add ${id} "${escaped}"`);
+  }
 }
 var BEADS_KEY = "beads_client";
 function getBeads(basePath) {
@@ -93958,6 +93962,11 @@ Request: ${prompt}`
     let finalResult = "";
     let didRemindForCompletion = false;
     let completionToolCalled = false;
+    const totalUsage = {
+      inputTokens: 0,
+      outputTokens: 0,
+      totalTokens: 0
+    };
     for (let i2 = 0;i2 < 50; i2++) {
       const config2 = getConfig();
       const { maxHistoryMessages = 20, maxToolResponseSize = 50000, maxMessageSize = 1e5 } = config2.context || {};
@@ -93981,6 +93990,12 @@ Request: ${prompt}`
         }
       }
       const result = await this.executeGenerateText(messages);
+      console.log("DEBUG: result.usage", JSON.stringify(result.usage));
+      if (result.usage) {
+        totalUsage.inputTokens += result.usage.inputTokens || 0;
+        totalUsage.outputTokens += result.usage.outputTokens || 0;
+        totalUsage.totalTokens += result.usage.totalTokens || 0;
+      }
       const assistantContent = [];
       if (result.text) {
         assistantContent.push({ type: "text", text: result.text });
@@ -94173,6 +94188,20 @@ If you are still working, continue with your next step.`
         break;
       }
     }
+    if (context2?.beadId) {
+      try {
+        const summary = `**Agent Execution Summary**
+- **Role**: ${this.role}
+- **Input Tokens**: ${totalUsage.inputTokens}
+- **Output Tokens**: ${totalUsage.outputTokens}
+- **Total Tokens**: ${totalUsage.totalTokens}`;
+        getBeads().addComment(context2.beadId, summary).catch((err) => {
+          logger.warn(`[${this.role}] Failed to report token usage to bead ${context2.beadId}`, { error: err });
+        });
+      } catch (err) {
+        logger.warn(`[${this.role}] Error preparing token usage report`, { error: err });
+      }
+    }
     return finalResult;
   }
 }
@@ -96068,7 +96097,7 @@ class BeadsClient2 {
     this.binary = binary2 || config2?.beads.binary || "bd";
   }
   async runCommand(args, retryCount = 0) {
-    const command = `${this.binary} --sandbox ${args}`;
+    const command = `${this.binary} --sandbox --no-db ${args}`;
     const cwd2 = this.basePath.endsWith(".beads") ? resolve10(this.basePath, "..") : this.basePath;
     try {
       const { stdout, stderr } = await this.execute(command, cwd2);
@@ -96346,6 +96375,10 @@ ${descText}`;
   async addDependency(childId, parentId) {
     await this.runCommand(`dep add ${childId} ${parentId}`);
   }
+  async addComment(id, comment) {
+    const escaped = comment.replace(/"/g, "\\\"");
+    return this.runCommand(`comments add ${id} "${escaped}"`);
+  }
 }
 var BEADS_KEY2 = "beads_client";
 function getBeads2(basePath) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "the-citadel",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "description": "A deterministic agent orchestration system for Knowledge Work",
   "module": "src/index.ts",
   "type": "module",

package/dist/citadel-forge/App.d.ts

@@ -1,3 +0,0 @@
-import React from 'react';
-declare const App: React.FC;
-export default App;

package/dist/citadel-forge/components/Sidebar.d.ts

@@ -1,9 +0,0 @@
-import React from 'react';
-import { CitadelFormula } from '../types';
-interface SidebarProps {
-    formula: CitadelFormula;
-    selectedStepId: string | null;
-    onClose: () => void;
-}
-declare const Sidebar: React.FC<SidebarProps>;
-export default Sidebar;

package/dist/citadel-forge/components/TextEditor.d.ts

@@ -1,7 +0,0 @@
-import React from 'react';
-interface TextEditorProps {
-    value: string;
-    onChange: (val: string) => void;
-}
-declare const TextEditor: React.FC<TextEditorProps>;
-export default TextEditor;

package/dist/citadel-forge/components/VisualEditor.d.ts

@@ -1,9 +0,0 @@
-import React from 'react';
-import { CitadelFormula } from '../types';
-interface VisualEditorProps {
-    formula: CitadelFormula;
-    selectedNodeId: string | null;
-    onNodeSelect: (stepId: string | null) => void;
-}
-declare const VisualEditor: React.FC<VisualEditorProps>;
-export default VisualEditor;

package/dist/citadel-forge/constants.d.ts

@@ -1,4 +0,0 @@
-export declare const INITIAL_FORMULA_TOML = "formula = \"smart_content_pipeline\"\ndescription = \"Research, draft, compliance check, and grade content using chained AI agents\"\n\n[vars.topic]\ndescription = \"The subject to generate content for\"\ndefault = \"The Future of Quantum Computing\"\nrequired = true\n\n# 1. Research Step\n[[steps]]\nid = \"research\"\ntitle = \"Research Agent\"\ndescription = \"Gathers key facts and sources\"\ncontext = { query = \"{{topic}}\", depth = \"detailed\" }\n\n  # Define what this step outputs\n  [steps.output_schema]\n  type = \"object\"\n  required = [\"facts\", \"sources\"]\n\n  [steps.output_schema.properties.facts]\n  type = \"array\"\n  [steps.output_schema.properties.facts.items]\n  type = \"string\"\n\n  [steps.output_schema.properties.sources]\n  type = \"array\"\n  [steps.output_schema.properties.sources.items]\n  type = \"object\"\n  properties = { url = { type = \"string\" }, title = { type = \"string\" } }\n\n\n# 2. Drafting Step (Uses output from Research)\n[[steps]]\nid = \"draft\"\ntitle = \"Writer Agent\"\nneeds = [\"research\"]\ncontext = { facts = \"{{steps.research.output.facts}}\", tone = \"professional\" }\n\n  [steps.output_schema]\n  type = \"object\"\n  required = [\"content\", \"word_count\"]\n  \n  [steps.output_schema.properties.content]\n  type = \"string\"\n  \n  [steps.output_schema.properties.word_count]\n  type = \"number\"\n\n\n# 3. Compliance Check (Simulated Failure Point)\n[[steps]]\nid = \"compliance\"\ntitle = \"Legal Compliance Scan\"\nneeds = [\"draft\"]\non_failure = \"sanitize_content\"\ncontext = { text = \"{{steps.draft.output.content}}\" }\n\n# 3b. Recovery Step (Runs only if compliance fails)\n[[steps]]\nid = \"sanitize_content\"\ntitle = \"Sanitize Content\"\ndescription = \"Removes restricted keywords\"\ncontext = { text = \"{{steps.draft.output.content}}\", mode = \"strict\" }\n\n\n# 4. Editing Step (Depends on Compliance)\n[[steps]]\nid = \"editor\"\ntitle = \"Quality Control\"\nneeds = [\"compliance\"]\ncontext = { text = \"{{steps.draft.output.content}}\", min_words = 500 }\n\n  [steps.output_schema]\n  type = \"object\"\n  required = [\"score\", \"approved\", \"feedback\"]\n  \n  [steps.output_schema.properties.score]\n  type = \"number\"\n  \n  [steps.output_schema.properties.approved]\n  type = \"boolean\"\n  \n  [steps.output_schema.properties.feedback]\n  type = \"string\"\n\n\n# 5. Publication (Conditional)\n[[steps]]\nid = \"publish\"\ntitle = \"CMS Publisher\"\ndescription = \"Publishes only if approved\"\nneeds = [\"editor\"]\n# Conditional logic: Skip unless approved\nif = \"{{steps.editor.output.approved}} == true\"\ncontext = { payload = \"{{steps.draft.output.content}}\", tags = [\"ai-generated\", \"{{topic}}\"] }\n";
-export declare const CONTENT_EXAMPLE = "formula = \"smart_content_pipeline\"\ndescription = \"Research, draft, compliance check, and grade content using chained AI agents\"\n\n[vars.topic]\ndescription = \"The subject to generate content for\"\ndefault = \"The Future of Quantum Computing\"\nrequired = true\n\n# 1. Research Step\n[[steps]]\nid = \"research\"\ntitle = \"Research Agent\"\ndescription = \"Gathers key facts and sources\"\ncontext = { query = \"{{topic}}\", depth = \"detailed\" }\n\n  # Define what this step outputs\n  [steps.output_schema]\n  type = \"object\"\n  required = [\"facts\", \"sources\"]\n\n  [steps.output_schema.properties.facts]\n  type = \"array\"\n  [steps.output_schema.properties.facts.items]\n  type = \"string\"\n\n  [steps.output_schema.properties.sources]\n  type = \"array\"\n  [steps.output_schema.properties.sources.items]\n  type = \"object\"\n  properties = { url = { type = \"string\" }, title = { type = \"string\" } }\n\n\n# 2. Drafting Step (Uses output from Research)\n[[steps]]\nid = \"draft\"\ntitle = \"Writer Agent\"\nneeds = [\"research\"]\ncontext = { facts = \"{{steps.research.output.facts}}\", tone = \"professional\" }\n\n  [steps.output_schema]\n  type = \"object\"\n  required = [\"content\", \"word_count\"]\n  \n  [steps.output_schema.properties.content]\n  type = \"string\"\n  \n  [steps.output_schema.properties.word_count]\n  type = \"number\"\n\n\n# 3. Compliance Check (Simulated Failure Point)\n[[steps]]\nid = \"compliance\"\ntitle = \"Legal Compliance Scan\"\nneeds = [\"draft\"]\non_failure = \"sanitize_content\"\ncontext = { text = \"{{steps.draft.output.content}}\" }\n\n# 3b. Recovery Step (Runs only if compliance fails)\n[[steps]]\nid = \"sanitize_content\"\ntitle = \"Sanitize Content\"\ndescription = \"Removes restricted keywords\"\ncontext = { text = \"{{steps.draft.output.content}}\", mode = \"strict\" }\n\n\n# 4. Editing Step (Depends on Compliance)\n[[steps]]\nid = \"editor\"\ntitle = \"Quality Control\"\nneeds = [\"compliance\"]\ncontext = { text = \"{{steps.draft.output.content}}\", min_words = 500 }\n\n  [steps.output_schema]\n  type = \"object\"\n  required = [\"score\", \"approved\", \"feedback\"]\n  \n  [steps.output_schema.properties.score]\n  type = \"number\"\n  \n  [steps.output_schema.properties.approved]\n  type = \"boolean\"\n  \n  [steps.output_schema.properties.feedback]\n  type = \"string\"\n\n\n# 5. Publication (Conditional)\n[[steps]]\nid = \"publish\"\ntitle = \"CMS Publisher\"\ndescription = \"Publishes only if approved\"\nneeds = [\"editor\"]\n# Conditional logic: Skip unless approved\nif = \"{{steps.editor.output.approved}} == true\"\ncontext = { payload = \"{{steps.draft.output.content}}\", tags = [\"ai-generated\", \"{{topic}}\"] }\n";
-export declare const MONOREPO_EXAMPLE = "formula = \"microservices_release\"\ndescription = \"Build, Test, and Deploy multiple services with schema validation\"\n\n[vars.env]\ndescription = \"Target environment (dev/staging/prod)\"\ndefault = \"dev\"\n\n[vars.services]\ndescription = \"Services to deploy\"\ndefault = \"auth,payment,notification\"\n\n# 1. Parallel Build Loop\n[[steps]]\nid = \"build\"\ntitle = \"Build {{svc}}\"\nfor = { items = \"{{services}}\", as = \"svc\" }\ndescription = \"Compiles code and builds docker image\"\n\n  [steps.output_schema]\n  type = \"object\"\n  required = [\"image_hash\", \"status\"]\n  properties = { image_hash = { type = \"string\" }, status = { type = \"string\" } }\n\n# 2. Integration Testing (Depends on all builds)\n[[steps]]\nid = \"integration_test\"\ntitle = \"System Integration Tests\"\nneeds = [\"build\"]\ncontext = { target_env = \"ci-sandbox\", modules = \"{{services}}\" }\non_failure = \"notify_slack\"\n\n  [steps.output_schema]\n  type = \"object\"\n  required = [\"passed\", \"coverage\"]\n  properties = { passed = { type = \"boolean\" }, coverage = { type = \"number\" } }\n\n# 2b. Failure Notification\n[[steps]]\nid = \"notify_slack\"\ntitle = \"Alert Engineering Team\"\ndescription = \"Triggered if tests fail\"\ncontext = { channel = \"#alerts-{{env}}\", severity = \"high\" }\n\n# 3. Security Scan (Gatekeeper)\n[[steps]]\nid = \"security_scan\"\ntitle = \"Vulnerability Scanner\"\nneeds = [\"build\"]\ncontext = { strict_mode = \"true\" }\n\n  [steps.output_schema]\n  type = \"object\"\n  required = [\"vulnerabilities\"]\n  properties = { vulnerabilities = { type = \"number\" } }\n\n# 4. Deploy (Conditional)\n[[steps]]\nid = \"deploy\"\ntitle = \"Deploy to {{env}}\"\nneeds = [\"integration_test\", \"security_scan\"]\nif = \"{{env}} == 'prod' || {{env}} == 'staging'\"\ncontext = { dry_run = \"false\", strategy = \"canary\" }\n\n# 5. Post-Deploy Verification\n[[steps]]\nid = \"verify\"\ntitle = \"Health Check\"\nneeds = [\"deploy\"]\ncontext = { endpoint = \"https://api.{{env}}.acme.com/health\" }\n";
-export declare const MIGRATION_EXAMPLE = "formula = \"critical_db_migration\"\ndescription = \"A safe database migration workflow with automatic rollback piping\"\n\n[vars.target_version]\ndescription = \"Schema version to apply\"\nrequired = true\n\n[vars.region]\ndefault = \"us-east-1\"\n\n# 1. Pre-flight Check\n[[steps]]\nid = \"preflight\"\ntitle = \"Check Database Health\"\ncontext = { region = \"{{region}}\" }\n\n# 2. Create Backup\n[[steps]]\nid = \"backup\"\ntitle = \"Snapshot Database\"\nneeds = [\"preflight\"]\ndescription = \"Creates a point-in-time recovery point\"\n\n  [steps.output_schema]\n  type = \"object\"\n  required = [\"snapshot_id\", \"timestamp\"]\n  \n  [steps.output_schema.properties.snapshot_id]\n  type = \"string\"\n  description = \"The ID required for rollback\"\n\n# 3. Apply Migration (Dangerous)\n[[steps]]\nid = \"apply_schema\"\ntitle = \"Apply Schema v{{target_version}}\"\nneeds = [\"backup\"]\non_failure = \"rollback\"\ncontext = { version = \"{{target_version}}\", timeout_seconds = 300 }\n\n  [steps.output_schema]\n  type = \"object\"\n  properties = { changes_applied = { type = \"number\" } }\n\n# 3b. Rollback (Recovery)\n# Uses Data Piping to get the EXACT snapshot ID from step 2\n[[steps]]\nid = \"rollback\"\ntitle = \"Emergency Rollback\"\ndescription = \"Restores DB using the snapshot from step 2\"\ncontext = { snapshot_id = \"{{steps.backup.output.snapshot_id}}\", force = true }\n\n# 4. Validation\n[[steps]]\nid = \"validate\"\ntitle = \"Validate Data Integrity\"\nneeds = [\"apply_schema\"]\nif = \"{{steps.apply_schema.output.changes_applied}} > 0\"\n\n# 5. Cleanup\n[[steps]]\nid = \"cleanup_backup\"\ntitle = \"Delete Temporary Snapshot\"\nneeds = [\"validate\"]\ncontext = { snapshot_id = \"{{steps.backup.output.snapshot_id}}\" }\n";

package/dist/citadel-forge/index.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/citadel-forge/services/geminiService.d.ts

@@ -1 +0,0 @@
-export declare const generateFormula: (prompt: string) => Promise<string>;

package/dist/citadel-forge/types.d.ts

@@ -1,36 +0,0 @@
-export interface CitadelVar {
-    name: string;
-    description?: string;
-    required?: boolean;
-    default?: string;
-}
-export interface CitadelLoop {
-    items: string;
-    as: string;
-}
-export interface CitadelSchema {
-    type: string;
-    description?: string;
-    required?: string[];
-    properties?: Record<string, CitadelSchema>;
-    items?: CitadelSchema;
-    enum?: string[];
-}
-export interface CitadelStep {
-    id: string;
-    title: string;
-    description?: string;
-    if?: string;
-    for?: CitadelLoop;
-    needs?: string[];
-    on_failure?: string;
-    context?: Record<string, any>;
-    output_schema?: CitadelSchema;
-}
-export interface CitadelFormula {
-    formula: string;
-    description: string;
-    vars: CitadelVar[];
-    steps: CitadelStep[];
-}
-export type ViewMode = 'split' | 'visual' | 'code';

package/dist/citadel-forge/utils/citadelParser.d.ts

@@ -1,11 +0,0 @@
-import { CitadelFormula } from '../types';
-/**
- * A lightweight, specific parser for the Citadel TOML subset.
- * Handles nested tables for schemas and inline objects for context.
- */
-export declare const parseCitadelTOML: (toml: string) => CitadelFormula;
-/**
- * Serializes the Citadel object back to TOML format.
- * (Partial implementation for core features, schema serialization is complex and skipped for brevity as app uses text editor primarily)
- */
-export declare const stringifyCitadelTOML: (data: CitadelFormula) => string;

package/dist/citadel-forge/vite.config.d.ts

@@ -1,2 +0,0 @@
-declare const _default: import("vite").UserConfigFnObject;
-export default _default;

package/dist/citadel.config.d.ts

@@ -1,71 +0,0 @@
-declare const _default: {
-    providers: {
-        openai?: {
-            apiKey?: string | undefined;
-        } | undefined;
-        anthropic?: {
-            apiKey?: string | undefined;
-        } | undefined;
-        ollama?: {
-            baseURL?: string | undefined;
-            apiKey?: string | undefined;
-        } | undefined;
-    };
-    agents: {
-        router: {
-            provider: "openai" | "anthropic" | "ollama";
-            model: string;
-            mcpTools?: string[] | undefined;
-        };
-        worker: {
-            provider: "openai" | "anthropic" | "ollama";
-            model: string;
-            mcpTools?: string[] | undefined;
-        };
-        supervisor: {
-            provider: "openai" | "anthropic" | "ollama";
-            model: string;
-            mcpTools?: string[] | undefined;
-        };
-        gatekeeper: {
-            provider: "openai" | "anthropic" | "ollama";
-            model: string;
-            mcpTools?: string[] | undefined;
-        };
-    };
-    worker: {
-        timeout?: number | undefined;
-        maxRetries?: number | undefined;
-        costLimit?: number | undefined;
-        min_workers?: number | undefined;
-        max_workers?: number | undefined;
-        load_factor?: number | undefined;
-    };
-    beads: {
-        path?: string | undefined;
-        binary?: string | undefined;
-        autoSync?: boolean | undefined;
-    };
-    env?: "development" | "production" | undefined;
-    mcpServers?: Record<string, {
-        command?: string | undefined;
-        args?: string[] | undefined;
-        env?: Record<string, string> | undefined;
-        url?: string | undefined;
-        headers?: Record<string, string> | undefined;
-    }> | undefined;
-    gatekeeper?: {
-        min_workers?: number | undefined;
-        max_workers?: number | undefined;
-        load_factor?: number | undefined;
-    } | undefined;
-    bridge?: {
-        maxLogs?: number | undefined;
-    } | undefined;
-    context?: {
-        maxHistoryMessages?: number | undefined;
-        maxToolResponseSize?: number | undefined;
-        maxMessageSize?: number | undefined;
-    } | undefined;
-};
-export default _default;

package/dist/scripts/verify-agents-md.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/src/index.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env bun
-export {};

package/dist/temp/test_schema.d.ts

@@ -1,6 +0,0 @@
-#!/usr/bin/env bun
-/**
- * Test script to verify JSON schema generation with real Ollama LLM
- * This reproduces the production error to identify the root cause
- */
-export {};

package/dist/tests/e2e/e2e.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/tests/integration/beads.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/tests/integration/concurrency.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/tests/integration/conductor.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/tests/integration/data_flow.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/tests/integration/ddp.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/tests/integration/hooks.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/tests/integration/queue.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/tests/integration/worker_tools.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/tests/mcp.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/tests/unit/agents.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/tests/unit/config.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/tests/workflow.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/tests/workflow_failure.test.d.ts

@@ -1 +0,0 @@
-export {};