the-citadel 0.8.4 → 0.9.0

package/dist/config/schema.d.ts

@@ -72,6 +72,9 @@ export declare const ConfigSchema: z.ZodObject<{
         maxToolResponseSize: z.ZodDefault<z.ZodNumber>;
         maxMessageSize: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>;
+    hooks: z.ZodOptional<z.ZodObject<{
+        onPearlDone: z.ZodOptional<z.ZodAny>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type CitadelConfig = z.infer<typeof ConfigSchema>;
 export type CitadelConfigInput = z.input<typeof ConfigSchema>;

package/dist/core/formula.d.ts

@@ -18,6 +18,7 @@ export declare const FormulaStepSchema: z.ZodObject<{
     output_schema: z.ZodOptional<z.ZodAny>;
     context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    agent: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const FormulaSchema: z.ZodObject<{
     formula: z.ZodString;
@@ -43,6 +44,7 @@ export declare const FormulaSchema: z.ZodObject<{
         output_schema: z.ZodOptional<z.ZodAny>;
         context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        agent: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type Formula = z.infer<typeof FormulaSchema>;

package/dist/core/instruction.d.ts

@@ -16,7 +16,7 @@ export interface InstructionProvider {
 export declare class GlobalProvider implements InstructionProvider {
     name: string;
     priority: number;
-    getInstructions(_ctx: InstructionContext): Promise<string | null>;
+    getInstructions(ctx: InstructionContext): Promise<string | null>;
 }
 /**
  * Hardcoded defaults for Citadel roles.

package/dist/index.js

@@ -3021,7 +3021,7 @@ var require_signal_exit = __commonJS((exports, module) => {
       emitter.on(ev, cb);
       return remove;
     };
-    unload = function unload() {
+    unload = function unload2() {
       if (!loaded || !processOk(global.process)) {
         return;
       }
@@ -3036,7 +3036,7 @@ var require_signal_exit = __commonJS((exports, module) => {
       emitter.count -= 1;
     };
     module.exports.unload = unload;
-    emit = function emit(event, code, signal) {
+    emit = function emit2(event, code, signal) {
       if (emitter.emitted[event]) {
         return;
       }
@@ -3065,7 +3065,7 @@ var require_signal_exit = __commonJS((exports, module) => {
       return signals;
     };
     loaded = false;
-    load = function load() {
+    load = function load2() {
       if (loaded || !processOk(global.process)) {
         return;
       }
@@ -3084,7 +3084,7 @@ var require_signal_exit = __commonJS((exports, module) => {
     };
     module.exports.load = load;
     originalProcessReallyExit = process3.reallyExit;
-    processReallyExit = function processReallyExit(code) {
+    processReallyExit = function processReallyExit2(code) {
       if (!processOk(global.process)) {
         return;
       }
@@ -3094,7 +3094,7 @@ var require_signal_exit = __commonJS((exports, module) => {
       originalProcessReallyExit.call(process3, process3.exitCode);
     };
     originalProcessEmit = process3.emit;
-    processEmit = function processEmit(ev, arg) {
+    processEmit = function processEmit2(ev, arg) {
       if (ev === "exit" && processOk(global.process)) {
         if (arg !== undefined) {
           process3.exitCode = arg;
@@ -18169,7 +18169,7 @@ var require_backend = __commonJS((exports, module) => {
           var LRU_LIST = Symbol("lruList");
           var CACHE = Symbol("cache");
           var UPDATE_AGE_ON_GET = Symbol("updateAgeOnGet");
-          var naiveLength = function naiveLength() {
+          var naiveLength = function naiveLength2() {
             return 1;
           };
           var LRUCache = /* @__PURE__ */ function() {
@@ -18420,7 +18420,7 @@ var require_backend = __commonJS((exports, module) => {
               }
             }]);
           }();
-          var _get = function _get(self2, key, doUse) {
+          var _get = function _get2(self2, key, doUse) {
             var node = self2[CACHE].get(key);
             if (node) {
               var hit = node.value;
@@ -18438,13 +18438,13 @@ var require_backend = __commonJS((exports, module) => {
               return hit.value;
             }
           };
-          var isStale = function isStale(self2, hit) {
+          var isStale = function isStale2(self2, hit) {
             if (!hit || !hit.maxAge && !self2[MAX_AGE])
               return false;
             var diff = Date.now() - hit.now;
             return hit.maxAge ? diff > hit.maxAge : self2[MAX_AGE] && diff > self2[MAX_AGE];
           };
-          var trim = function trim(self2) {
+          var trim = function trim2(self2) {
             if (self2[LENGTH] > self2[MAX]) {
               for (var walker = self2[LRU_LIST].tail;self2[LENGTH] > self2[MAX] && walker !== null; ) {
                 var prev = walker.prev;
@@ -18453,7 +18453,7 @@ var require_backend = __commonJS((exports, module) => {
               }
             }
           };
-          var _del = function _del(self2, node) {
+          var _del = function _del2(self2, node) {
             if (node) {
               var hit = node.value;
               if (self2[DISPOSE])
@@ -18463,15 +18463,15 @@ var require_backend = __commonJS((exports, module) => {
               self2[LRU_LIST].removeNode(node);
             }
           };
-          var Entry = /* @__PURE__ */ _createClass(function Entry(key, value, length, now, maxAge) {
-            _classCallCheck(this, Entry);
+          var Entry = /* @__PURE__ */ _createClass(function Entry2(key, value, length, now, maxAge) {
+            _classCallCheck(this, Entry2);
             this.key = key;
             this.value = value;
             this.length = length;
             this.now = now;
             this.maxAge = maxAge || 0;
           });
-          var forEachStep = function forEachStep(self2, fn, node, thisp) {
+          var forEachStep = function forEachStep2(self2, fn, node, thisp) {
             var hit = node.value;
             if (isStale(self2, hit)) {
               _del(self2, node);
@@ -18780,7 +18780,7 @@ var require_backend = __commonJS((exports, module) => {
           }
           function _regeneratorRuntime() {
             /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/facebook/regenerator/blob/main/LICENSE */
-            _regeneratorRuntime = function _regeneratorRuntime() {
+            _regeneratorRuntime = function _regeneratorRuntime2() {
               return e;
             };
             var t, e = {}, r = Object.prototype, n = r.hasOwnProperty, o = Object.defineProperty || function(t2, e2, r2) {
@@ -18792,7 +18792,7 @@ var require_backend = __commonJS((exports, module) => {
             try {
               define2({}, "");
             } catch (t2) {
-              define2 = function define(t3, e2, r2) {
+              define2 = function define3(t3, e2, r2) {
                 return t3[e2] = r2;
               };
             }
@@ -19708,7 +19708,7 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
           if (Array.isArray(arr))
             return arr;
         }
-        var compareVersions = function compareVersions(v1, v2) {
+        var compareVersions = function compareVersions2(v1, v2) {
           var n1 = validateAndParse(v1);
           var n2 = validateAndParse(v2);
           var p1 = n1.pop();
@@ -19723,15 +19723,15 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
           }
           return 0;
         };
-        var validate2 = function validate(version) {
+        var validate2 = function validate3(version) {
           return typeof version === "string" && /^[v\d]/.test(version) && semver.test(version);
         };
-        var compare = function compare(v1, v2, operator) {
+        var compare = function compare2(v1, v2, operator) {
           assertValidOperator(operator);
           var res = compareVersions(v1, v2);
           return operatorResMap[operator].includes(res);
         };
-        var satisfies = function satisfies(version, range) {
+        var satisfies = function satisfies2(version, range) {
           var m = range.match(/^([<>=~^]+)/);
           var op = m ? m[1] : "=";
           if (op !== "^" && op !== "~")
@@ -19759,7 +19759,7 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
           return true;
         };
         var semver = /^[v^~<>=]*?(\d+)(?:\.([x*]|\d+)(?:\.([x*]|\d+)(?:\.([x*]|\d+))?(?:-([\da-z\-]+(?:\.[\da-z\-]+)*))?(?:\+[\da-z\-]+(?:\.[\da-z\-]+)*)?)?)?$/i;
-        var validateAndParse = function validateAndParse(version) {
+        var validateAndParse = function validateAndParse2(version) {
           if (typeof version !== "string") {
             throw new TypeError("Invalid argument expected string");
           }
@@ -19770,17 +19770,17 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
           match.shift();
           return match;
         };
-        var isWildcard = function isWildcard(s) {
+        var isWildcard = function isWildcard2(s) {
           return s === "*" || s === "x" || s === "X";
         };
-        var tryParse = function tryParse(v) {
+        var tryParse = function tryParse2(v) {
           var n = parseInt(v, 10);
           return isNaN(n) ? v : n;
         };
-        var forceType = function forceType(a, b) {
+        var forceType = function forceType2(a, b) {
           return esm_typeof(a) !== esm_typeof(b) ? [String(a), String(b)] : [a, b];
         };
-        var compareStrings = function compareStrings(a, b) {
+        var compareStrings = function compareStrings2(a, b) {
           if (isWildcard(a) || isWildcard(b))
             return 0;
           var _forceType = forceType(tryParse(a), tryParse(b)), _forceType2 = _slicedToArray(_forceType, 2), ap = _forceType2[0], bp = _forceType2[1];
@@ -19790,7 +19790,7 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
             return -1;
           return 0;
         };
-        var compareSegments = function compareSegments(a, b) {
+        var compareSegments = function compareSegments2(a, b) {
           for (var i = 0;i < Math.max(a.length, b.length); i++) {
             var r = compareStrings(a[i] || "0", b[i] || "0");
             if (r !== 0)
@@ -19806,7 +19806,7 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
           "<": [-1]
         };
         var allowedOperators = Object.keys(operatorResMap);
-        var assertValidOperator = function assertValidOperator(op) {
+        var assertValidOperator = function assertValidOperator2(op) {
           if (typeof op !== "string") {
             throw new TypeError("Invalid operator type, expected string but got ".concat(esm_typeof(op)));
           }
@@ -20047,7 +20047,7 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
         function getAllEnumerableKeys(obj) {
           var keys = new Set;
           var current = obj;
-          var _loop = function _loop() {
+          var _loop = function _loop2() {
             var currentKeys = [].concat(_toConsumableArray(Object.keys(current)), _toConsumableArray(Object.getOwnPropertySymbols(current)));
             var descriptors = Object.getOwnPropertyDescriptors(current);
             currentKeys.forEach(function(key) {
@@ -20848,7 +20848,7 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
               }
           }
         }
-        var isPlainObject = function isPlainObject(object) {
+        var isPlainObject = function isPlainObject2(object) {
           var objectPrototype = Object.getPrototypeOf(object);
           if (!objectPrototype)
             return true;
@@ -21644,7 +21644,7 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
           var b = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : "";
           return compareVersions(a, b) > -1;
         }
-        var isReactNativeEnvironment = function isReactNativeEnvironment() {
+        var isReactNativeEnvironment = function isReactNativeEnvironment2() {
           return window.document == null;
         };
         function formatDurationToMicrosecondsGranularity(duration) {
@@ -22384,7 +22384,7 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
             event.preventDefault();
             event.stopPropagation();
           }
-          var selectElementForNode = function selectElementForNode(node) {
+          var selectElementForNode = function selectElementForNode2(node) {
             var match = agent2.getIDForHostInstance(node, inspectOnlySuspenseNodes);
             if (match !== null) {
               bridge.send("selectElement", match.id);
@@ -22782,12 +22782,12 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
           try {
             var t = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function() {}));
           } catch (t2) {}
-          return (_isNativeReflectConstruct = function _isNativeReflectConstruct() {
+          return (_isNativeReflectConstruct = function _isNativeReflectConstruct2() {
             return !!t;
           })();
         }
         function _getPrototypeOf(o) {
-          _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function _getPrototypeOf(o2) {
+          _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function _getPrototypeOf2(o2) {
             return o2.__proto__ || Object.getPrototypeOf(o2);
           };
           return _getPrototypeOf(o);
@@ -22802,7 +22802,7 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
             _setPrototypeOf(subClass, superClass);
         }
         function _setPrototypeOf(o, p) {
-          _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function _setPrototypeOf(o2, p2) {
+          _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function _setPrototypeOf2(o2, p2) {
             o2.__proto__ = p2;
             return o2;
           };
@@ -23055,12 +23055,12 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
           try {
             var t = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function() {}));
           } catch (t2) {}
-          return (agent_isNativeReflectConstruct = function _isNativeReflectConstruct() {
+          return (agent_isNativeReflectConstruct = function _isNativeReflectConstruct2() {
             return !!t;
           })();
         }
         function agent_getPrototypeOf(o) {
-          agent_getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function _getPrototypeOf(o2) {
+          agent_getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function _getPrototypeOf2(o2) {
             return o2.__proto__ || Object.getPrototypeOf(o2);
           };
           return agent_getPrototypeOf(o);
@@ -23075,7 +23075,7 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
             agent_setPrototypeOf(subClass, superClass);
         }
         function agent_setPrototypeOf(o, p) {
-          agent_setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function _setPrototypeOf(o2, p2) {
+          agent_setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function _setPrototypeOf2(o2, p2) {
             o2.__proto__ = p2;
             return o2;
           };
@@ -23106,7 +23106,7 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
           }
           return (r === "string" ? String : Number)(t);
         }
-        var debug = function debug(methodName) {
+        var debug = function debug2(methodName) {
           if (__DEBUG__) {
             var _console;
             for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1;_key < _len; _key++) {
@@ -24058,7 +24058,7 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
                 var control;
                 try {
                   if (construct) {
-                    var Fake = function Fake() {
+                    var Fake = function Fake2() {
                       throw Error();
                     };
                     Object.defineProperty(Fake.prototype, "props", {
@@ -26124,7 +26124,7 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
               if (it)
                 o = it;
               var i = 0;
-              var F = function F() {};
+              var F = function F2() {};
               return { s: F, n: function n() {
                 if (i >= o.length)
                   return { done: true };
@@ -31292,7 +31292,7 @@ The error thrown in the component is:
               isFullMatch: trackedPathMatchDepth === trackedPath.length - 1
             };
           }
-          var formatPriorityLevel = function formatPriorityLevel(priorityLevel) {
+          var formatPriorityLevel = function formatPriorityLevel2(priorityLevel) {
             if (priorityLevel == null) {
               return "Unknown";
             }
@@ -31540,19 +31540,19 @@ The error thrown in the component is:
           var internalInstanceToRootIDMap = new WeakMap;
           var getElementIDForHostInstance = null;
           var findHostInstanceForInternalID;
-          var getNearestMountedDOMNode = function getNearestMountedDOMNode(node) {
+          var getNearestMountedDOMNode = function getNearestMountedDOMNode2(node) {
             return null;
           };
           if (renderer.ComponentTree) {
-            getElementIDForHostInstance = function getElementIDForHostInstance(node) {
+            getElementIDForHostInstance = function getElementIDForHostInstance2(node) {
               var internalInstance = renderer.ComponentTree.getClosestInstanceFromNode(node);
               return internalInstanceToIDMap.get(internalInstance) || null;
             };
-            findHostInstanceForInternalID = function findHostInstanceForInternalID(id) {
+            findHostInstanceForInternalID = function findHostInstanceForInternalID2(id) {
               var internalInstance = idToInternalInstanceMap.get(id);
               return renderer.ComponentTree.getNodeFromInstance(internalInstance);
             };
-            getNearestMountedDOMNode = function getNearestMountedDOMNode(node) {
+            getNearestMountedDOMNode = function getNearestMountedDOMNode2(node) {
               var internalInstance = renderer.ComponentTree.getClosestInstanceFromNode(node);
               if (internalInstance != null) {
                 return renderer.ComponentTree.getNodeFromInstance(internalInstance);
@@ -31560,10 +31560,10 @@ The error thrown in the component is:
               return null;
             };
           } else if (renderer.Mount.getID && renderer.Mount.getNode) {
-            getElementIDForHostInstance = function getElementIDForHostInstance(node) {
+            getElementIDForHostInstance = function getElementIDForHostInstance2(node) {
               return null;
             };
-            findHostInstanceForInternalID = function findHostInstanceForInternalID(id) {
+            findHostInstanceForInternalID = function findHostInstanceForInternalID2(id) {
               return null;
             };
           }
@@ -32274,29 +32274,29 @@ The error thrown in the component is:
               }
             }
           }
-          var getProfilingData = function getProfilingData() {
+          var getProfilingData = function getProfilingData2() {
             throw new Error("getProfilingData not supported by this renderer");
           };
-          var handleCommitFiberRoot = function handleCommitFiberRoot() {
+          var handleCommitFiberRoot = function handleCommitFiberRoot2() {
             throw new Error("handleCommitFiberRoot not supported by this renderer");
           };
-          var handleCommitFiberUnmount = function handleCommitFiberUnmount() {
+          var handleCommitFiberUnmount = function handleCommitFiberUnmount2() {
             throw new Error("handleCommitFiberUnmount not supported by this renderer");
           };
-          var handlePostCommitFiberRoot = function handlePostCommitFiberRoot() {
+          var handlePostCommitFiberRoot = function handlePostCommitFiberRoot2() {
             throw new Error("handlePostCommitFiberRoot not supported by this renderer");
           };
-          var overrideError = function overrideError() {
+          var overrideError = function overrideError2() {
             throw new Error("overrideError not supported by this renderer");
           };
-          var overrideSuspense = function overrideSuspense() {
+          var overrideSuspense = function overrideSuspense2() {
             throw new Error("overrideSuspense not supported by this renderer");
           };
-          var overrideSuspenseMilestone = function overrideSuspenseMilestone() {
+          var overrideSuspenseMilestone = function overrideSuspenseMilestone2() {
             throw new Error("overrideSuspenseMilestone not supported by this renderer");
           };
-          var startProfiling = function startProfiling() {};
-          var stopProfiling = function stopProfiling() {};
+          var startProfiling = function startProfiling2() {};
+          var stopProfiling = function stopProfiling2() {};
           function getBestMatchForTrackedPath() {
             return null;
           }
@@ -32514,7 +32514,7 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
               if (it)
                 o = it;
               var i = 0;
-              var F = function F() {};
+              var F = function F2() {};
               return { s: F, n: function n() {
                 if (i >= o.length)
                   return { done: true };
@@ -32762,10 +32762,10 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
               return;
             }
             var consoleMethodsToOverrideForStrictMode = ["group", "groupCollapsed", "info", "log"];
-            var _loop = function _loop() {
+            var _loop = function _loop2() {
               var method = _consoleMethodsToOver[_i];
               var originalMethod = targetConsole[method];
-              var overrideMethod = function overrideMethod() {
+              var overrideMethod = function overrideMethod2() {
                 var settings = hook.settings;
                 for (var _len = arguments.length, args = new Array(_len), _key = 0;_key < _len; _key++) {
                   args[_key] = arguments[_key];
@@ -32827,10 +32827,10 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
               return;
             }
             var consoleMethodsToOverrideForErrorsAndWarnings = ["error", "trace", "warn"];
-            var _loop2 = function _loop2() {
+            var _loop2 = function _loop22() {
               var method = _consoleMethodsToOver2[_i2];
               var originalMethod = targetConsole[method];
-              var overrideMethod = function overrideMethod() {
+              var overrideMethod = function overrideMethod2() {
                 var settings = hook.settings;
                 for (var _len2 = arguments.length, args = new Array(_len2), _key2 = 0;_key2 < _len2; _key2++) {
                   args[_key2] = arguments[_key2];
@@ -32851,7 +32851,7 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
                 var shouldShowInlineWarningsAndErrors = settings.showInlineWarningsAndErrors && (method === "error" || method === "warn");
                 var _iterator = hook_createForOfIteratorHelper(hook.rendererInterfaces.values()), _step;
                 try {
-                  var _loop3 = function _loop3() {
+                  var _loop3 = function _loop32() {
                     var rendererInterface = _step.value;
                     var { onErrorOrWarning, getComponentStack } = rendererInterface;
                     try {
@@ -33006,7 +33006,7 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
           });
           hook.emit("react-devtools", agent2);
           hook.reactDevtoolsAgent = agent2;
-          var onAgentShutdown = function onAgentShutdown() {
+          var onAgentShutdown = function onAgentShutdown2() {
             subs.forEach(function(fn) {
               return fn();
             });
@@ -33442,7 +33442,7 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
             } else {
               var lazyResolveRNStyle;
               var lazyNativeStyleEditorValidAttributes;
-              var initAfterTick = function initAfterTick() {
+              var initAfterTick = function initAfterTick2() {
                 if (bridge !== null) {
                   setupNativeStyleEditor(bridge, agent2, lazyResolveRNStyle, lazyNativeStyleEditorValidAttributes);
                 }
@@ -42612,7 +42612,7 @@ var require_formats = __commonJS((exports) => {
   }
   var TIME = /^(\d\d):(\d\d):(\d\d(?:\.\d+)?)(z|([+-])(\d\d)(?::?(\d\d))?)?$/i;
   function getTime(strictTimeZone) {
-    return function time(str) {
+    return function time3(str) {
       const matches = TIME.exec(str);
       if (!matches)
         return false;
@@ -65048,7 +65048,10 @@ var ConfigSchema = exports_external.object({
     maxHistoryMessages: 20,
     maxToolResponseSize: 50000,
     maxMessageSize: 1e5
-  })
+  }),
+  hooks: exports_external.object({
+    onPearlDone: exports_external.any().optional()
+  }).optional()
 });
 
 // src/config/index.ts
@@ -84833,9 +84836,23 @@ ${stderr}`));
       const valStr = JSON.stringify(changes.output);
       await this.runCommand(["meta", "set", id, "output", valStr, "--format", "json"]);
     }
-    if (!output)
-      return this.get(id);
-    return this.parseRaw(output);
+    let finalPearl;
+    if (!output) {
+      finalPearl = await this.get(id);
+    } else {
+      finalPearl = this.parseRaw(output);
+    }
+    if (changes.status === "done" && current?.status !== "done") {
+      try {
+        const config2 = getConfig();
+        if (config2.hooks?.onPearlDone) {
+          await config2.hooks.onPearlDone(finalPearl);
+        }
+      } catch (err) {
+        logger.error(`[Pearls] Error executing onPearlDone hook for ${id}:`, err);
+      }
+    }
+    return finalPearl;
   }
   validateTransition(current, next) {
     const validTransitions = {
@@ -84897,7 +84914,8 @@ var FormulaStepSchema = exports_external.object({
   on_failure: exports_external.string().optional(),
   output_schema: exports_external.any().optional(),
   context: exports_external.record(exports_external.string(), exports_external.string()).optional(),
-  labels: exports_external.array(exports_external.string()).optional()
+  labels: exports_external.array(exports_external.string()).optional(),
+  agent: exports_external.string().optional()
 });
 var FormulaSchema = exports_external.object({
   formula: exports_external.string(),
@@ -85034,7 +85052,27 @@ ${results.join(`
 class GlobalProvider {
   name = "global";
   priority = 10;
-  async getInstructions(_ctx) {
+  async getInstructions(ctx) {
+    if (ctx.pearlId) {
+      try {
+        const pearl = await getPearls().get(ctx.pearlId);
+        if (pearl.assignee) {
+          const agentPath = resolve7(process.cwd(), `agents/${pearl.assignee}.md`);
+          if (existsSync6(agentPath)) {
+            const content = await readFile3(agentPath, "utf-8");
+            return `
+# AGENT ROLE: ${pearl.assignee.toUpperCase()}
+You are acting as ${pearl.assignee}. Follow these specific instructions and style guidelines:
+
+## Role Configuration
+${content}
+`;
+          }
+        }
+      } catch (err) {
+        logger.warn(`[GlobalProvider] Error fetching assignee prompt for ${ctx.pearlId}: ${err}`);
+      }
+    }
     const projectContext = await getProjectContext().resolveContext(process.cwd(), process.cwd());
     if (!projectContext)
       return null;
@@ -96565,9 +96603,23 @@ ${stderr}`));
       const valStr = JSON.stringify(changes.output);
       await this.runCommand(["meta", "set", id, "output", valStr, "--format", "json"]);
     }
-    if (!output)
-      return this.get(id);
-    return this.parseRaw(output);
+    let finalPearl;
+    if (!output) {
+      finalPearl = await this.get(id);
+    } else {
+      finalPearl = this.parseRaw(output);
+    }
+    if (changes.status === "done" && current?.status !== "done") {
+      try {
+        const config2 = getConfig();
+        if (config2.hooks?.onPearlDone) {
+          await config2.hooks.onPearlDone(finalPearl);
+        }
+      } catch (err) {
+        logger.error(`[Pearls] Error executing onPearlDone hook for ${id}:`, err);
+      }
+    }
+    return finalPearl;
   }
   validateTransition(current, next) {
     const validTransitions = {
@@ -97219,7 +97271,8 @@ class WorkflowEngine {
           parent: rootPearl.id,
           description,
           context: finalContext,
-          labels: step.labels
+          labels: step.labels,
+          assignee: step.agent
         });
         await pearls.update(pearl.id, {
           labels: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "the-citadel",
-  "version": "0.8.4",
+  "version": "0.9.0",
   "description": "A deterministic agent orchestration system for Knowledge Work",
   "module": "src/index.ts",
   "type": "module",
@@ -58,4 +58,4 @@
     "react": "^19.2.3",
     "zod": "^4.3.6"
   }
-}
+}

package/dist/agents/router.d.ts

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

package/dist/core/beads.d.ts

@@ -1,70 +0,0 @@
-import { z } from "zod";
-export declare const BeadStatusSchema: z.ZodEnum<{
-    open: "open";
-    in_progress: "in_progress";
-    verify: "verify";
-    done: "done";
-}>;
-export type BeadStatus = z.infer<typeof BeadStatusSchema>;
-export declare const BeadPrioritySchema: z.ZodPipe<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<"0">, z.ZodLiteral<"1">, z.ZodLiteral<"2">, z.ZodLiteral<"3">]>, z.ZodTransform<0 | 2 | 3 | 1, 0 | "0" | "1" | 2 | "2" | 3 | 1 | "3">>;
-export type BeadPriority = z.infer<typeof BeadPrioritySchema>;
-export declare const BeadSchema: z.ZodObject<{
-    id: z.ZodString;
-    title: z.ZodString;
-    status: z.ZodEnum<{
-        open: "open";
-        in_progress: "in_progress";
-        verify: "verify";
-        done: "done";
-    }>;
-    priority: z.ZodPipe<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<"0">, z.ZodLiteral<"1">, z.ZodLiteral<"2">, z.ZodLiteral<"3">]>, z.ZodTransform<0 | 2 | 3 | 1, 0 | "0" | "1" | 2 | "2" | 3 | 1 | "3">>;
-    assignee: z.ZodOptional<z.ZodString>;
-    labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    blockers: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    acceptance_test: z.ZodOptional<z.ZodString>;
-    parent: z.ZodOptional<z.ZodString>;
-    type: z.ZodOptional<z.ZodString>;
-    description: z.ZodOptional<z.ZodString>;
-    context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    created_at: z.ZodString;
-    updated_at: z.ZodString;
-}, z.core.$strip>;
-export type Bead = z.infer<typeof BeadSchema>;
-export interface CreateOptions {
-    priority?: 0 | 1 | 2 | 3;
-    assignee?: string;
-    blockers?: string[];
-    acceptance_test?: string;
-    description?: string;
-    parent?: string;
-    type?: string;
-    context?: Record<string, unknown>;
-    labels?: string[];
-}
-export declare class BeadsClient {
-    private basePath;
-    private binary;
-    constructor(basePath?: string, binary?: string);
-    protected runCommand(args: string, retryCount?: number): Promise<string>;
-    init(): Promise<void>;
-    protected execute(command: string, cwd: string): Promise<{
-        stdout: string;
-        stderr: string;
-    }>;
-    sync(): Promise<void>;
-    doctor(): Promise<boolean>;
-    private parseRaw;
-    private parseRawList;
-    private mapToDomain;
-    list(status?: BeadStatus): Promise<Bead[]>;
-    ready(): Promise<Bead[]>;
-    getAll(): Promise<Bead[]>;
-    get(id: string): Promise<Bead>;
-    create(title: string, options?: CreateOptions): Promise<Bead>;
-    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/tools/router.d.ts

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