@almadar/std 3.14.0 → 4.0.0

package/dist/index.js

@@ -25,7 +25,8 @@ var STD_MODULES = [
   "agent",
   "graph",
   "contract",
-  "data"
+  "data",
+  "composition"
 ];
 var STD_OPERATOR_CATEGORIES = [
   "std-math",
@@ -42,6 +43,7 @@ var STD_OPERATOR_CATEGORIES = [
   "std-prob",
   "std-os",
   "std-agent",
+  "std-composition",
   "ml-arch",
   "ml-effect",
   "ml-tensor",
@@ -3841,6 +3843,98 @@ var AGENT_OPERATORS = {
   }
 };
 
+// modules/composition.ts
+var COMPOSITION_OPERATORS = {
+  "behavior/compose": {
+    module: "composition",
+    category: "std-composition",
+    minArity: 1,
+    maxArity: 1,
+    description: "Compose N orbitals into one application schema. Wires events, picks layout, generates pages.",
+    hasSideEffects: false,
+    compileTime: true,
+    returnType: "object",
+    params: [
+      {
+        name: "config",
+        type: "object",
+        description: "ComposeBehaviorsInput: { appName, orbitals[], layoutStrategy?, eventWiring?, entityMappings? }"
+      }
+    ],
+    example: '(behavior/compose { appName: "ShoppingApp" orbitals: [...] })'
+  },
+  "behavior/wire": {
+    module: "composition",
+    category: "std-composition",
+    minArity: 2,
+    maxArity: 2,
+    description: "Apply cross-orbital event wiring. Adds external emits/listens to inline traits.",
+    hasSideEffects: false,
+    compileTime: true,
+    returnType: "array",
+    params: [
+      {
+        name: "orbitals",
+        type: "array",
+        description: "Array of OrbitalDefinition to wire"
+      },
+      {
+        name: "wiring",
+        type: "array",
+        description: "Array of EventWiringEntry { from, event, to, triggers }"
+      }
+    ],
+    example: "(behavior/wire orbitals wiring)"
+  },
+  "behavior/detect-layout": {
+    module: "composition",
+    category: "std-composition",
+    minArity: 1,
+    maxArity: 2,
+    description: "Auto-detect layout from orbital count and wiring topology. Returns single, tabs, sidebar, dashboard, or wizard-flow.",
+    hasSideEffects: false,
+    compileTime: true,
+    returnType: "string",
+    params: [
+      {
+        name: "orbitals",
+        type: "array",
+        description: "Array of OrbitalDefinition"
+      },
+      {
+        name: "wiring",
+        type: "array",
+        description: "Optional EventWiringEntry array",
+        optional: true
+      }
+    ],
+    example: "(behavior/detect-layout orbitals)"
+  },
+  "behavior/pipe": {
+    module: "composition",
+    category: "std-composition",
+    minArity: 2,
+    maxArity: null,
+    description: "Left-to-right composition. Each step receives the previous result as its first arg.",
+    hasSideEffects: false,
+    compileTime: true,
+    returnType: "any",
+    params: [
+      {
+        name: "seed",
+        type: "any",
+        description: "Initial value to pipe through steps"
+      },
+      {
+        name: "...steps",
+        type: "function[]",
+        description: "Functions, each receiving the previous result as first argument"
+      }
+    ],
+    example: '(behavior/pipe orbitals (behavior/wire wiring) (behavior/compose { appName: "X" }))'
+  }
+};
+
 // registry.ts
 var STD_OPERATORS = {
   ...MATH_OPERATORS,
@@ -3856,7 +3950,8 @@ var STD_OPERATORS = {
   ...TRAIN_OPERATORS,
   ...PROB_OPERATORS,
   ...OS_OPERATORS,
-  ...AGENT_OPERATORS
+  ...AGENT_OPERATORS,
+  ...COMPOSITION_OPERATORS
 };
 var STD_OPERATORS_BY_MODULE = {
   math: MATH_OPERATORS,
@@ -3872,7 +3967,8 @@ var STD_OPERATORS_BY_MODULE = {
   train: TRAIN_OPERATORS,
   prob: PROB_OPERATORS,
   os: OS_OPERATORS,
-  agent: AGENT_OPERATORS
+  agent: AGENT_OPERATORS,
+  composition: COMPOSITION_OPERATORS
 };
 function getStdOperatorMeta(operator) {
   return STD_OPERATORS[operator];
@@ -24876,187 +24972,9 @@ function stdAgentCompletion(params = {}) {
   };
   return makeOrbital(`${c.entityName}Orbital`, entity, [modalTrait, notifTrait, agentTrait], [page]);
 }
-function resolve92(params) {
-  const entityName = params.entityName ?? "ActivityEntry";
-  const p = plural(entityName);
-  const requiredFields = [
-    { name: "action", type: "string", default: "" },
-    { name: "detail", type: "string", default: "" },
-    { name: "status", type: "string", default: "pending" },
-    { name: "timestamp", type: "string", default: "" },
-    { name: "duration", type: "number", default: 0 }
-  ];
-  const baseFields = params.fields ?? [];
-  const existingNames = new Set(baseFields.map((f) => f.name));
-  const mergedFields = [
-    ...baseFields,
-    ...requiredFields.filter((f) => !existingNames.has(f.name))
-  ];
-  const fields = ensureIdField(mergedFields);
-  return {
-    entityName,
-    fields,
-    persistence: params.persistence ?? "persistent",
-    traitName: `${entityName}Log`,
-    pluralName: p,
-    pageName: params.pageName ?? `${entityName}Page`,
-    pagePath: params.pagePath ?? `/${p.toLowerCase()}`,
-    isInitial: params.isInitial ?? false
-  };
-}
-function buildEntity78(c) {
-  return makeEntity({ name: c.entityName, fields: c.fields, persistence: c.persistence });
-}
-function buildTrait71(c) {
-  const { entityName } = c;
-  const loggingUI = {
-    type: "stack",
-    direction: "vertical",
-    gap: "lg",
-    children: [
-      {
-        type: "stack",
-        direction: "horizontal",
-        gap: "sm",
-        justify: "space-between",
-        align: "center",
-        children: [
-          {
-            type: "stack",
-            direction: "horizontal",
-            gap: "sm",
-            align: "center",
-            children: [
-              { type: "icon", name: "activity", size: "lg" },
-              { type: "typography", content: "Activity Log", variant: "h2" }
-            ]
-          },
-          { type: "button", label: "Clear", event: "CLEAR", variant: "ghost", icon: "trash" }
-        ]
-      },
-      { type: "divider" },
-      {
-        type: "timeline",
-        entity: entityName,
-        emptyIcon: "activity",
-        emptyTitle: "No activity yet",
-        emptyDescription: "Agent actions will appear here as they occur.",
-        renderItem: ["fn", "item", {
-          type: "stack",
-          direction: "vertical",
-          gap: "xs",
-          children: [
-            {
-              type: "stack",
-              direction: "horizontal",
-              gap: "sm",
-              align: "center",
-              children: [
-                { type: "badge", label: "@item.status" },
-                { type: "typography", variant: "h4", content: "@item.action" }
-              ]
-            },
-            { type: "typography", variant: "body", color: "muted", content: "@item.detail" },
-            {
-              type: "stack",
-              direction: "horizontal",
-              gap: "sm",
-              align: "center",
-              children: [
-                { type: "typography", variant: "caption", color: "muted", content: "@item.timestamp" },
-                { type: "badge", label: "@item.duration", variant: "outline" }
-              ]
-            }
-          ]
-        }]
-      }
-    ]
-  };
-  return {
-    name: c.traitName,
-    linkedEntity: entityName,
-    category: "interaction",
-    emits: [
-      { event: "LOG_ENTRY", scope: "external", payload: [
-        { name: "action", type: "string" },
-        { name: "detail", type: "string" },
-        { name: "status", type: "string" }
-      ] }
-    ],
-    listens: [
-      { event: "LOG_ENTRY", triggers: "LOG_ENTRY", scope: "external" }
-    ],
-    stateMachine: {
-      states: [
-        { name: "logging", isInitial: true }
-      ],
-      events: [
-        { key: "INIT", name: "Initialize" },
-        { key: "LOG_ENTRY", name: "Log Entry", payload: [
-          { name: "action", type: "string", required: true },
-          { name: "detail", type: "string", required: true },
-          { name: "status", type: "string", required: true }
-        ] },
-        { key: "CLEAR", name: "Clear Log" }
-      ],
-      transitions: [
-        {
-          from: "logging",
-          to: "logging",
-          event: "INIT",
-          effects: [
-            ["fetch", entityName],
-            ["render-ui", "main", loggingUI]
-          ]
-        },
-        {
-          from: "logging",
-          to: "logging",
-          event: "LOG_ENTRY",
-          effects: [
-            ["persist", "create", entityName, {
-              action: "@payload.action",
-              detail: "@payload.detail",
-              status: "@payload.status",
-              timestamp: "@now"
-            }],
-            ["fetch", entityName],
-            ["render-ui", "main", loggingUI]
-          ]
-        },
-        {
-          from: "logging",
-          to: "logging",
-          event: "CLEAR",
-          effects: [
-            ["persist", "delete", entityName],
-            ["fetch", entityName],
-            ["render-ui", "main", loggingUI]
-          ]
-        }
-      ]
-    }
-  };
-}
-function buildPage72(c) {
-  return makePage({ name: c.pageName, path: c.pagePath, traitName: c.traitName, isInitial: c.isInitial });
-}
-function stdAgentActivityLogEntity(params = {}) {
-  return buildEntity78(resolve92(params));
-}
-function stdAgentActivityLogTrait(params = {}) {
-  return buildTrait71(resolve92(params));
-}
-function stdAgentActivityLogPage(params = {}) {
-  return buildPage72(resolve92(params));
-}
-function stdAgentActivityLog(params = {}) {
-  const c = resolve92(params);
-  return makeOrbital(`${c.entityName}Orbital`, buildEntity78(c), [buildTrait71(c)], [buildPage72(c)]);
-}
 
 // behaviors/functions/molecules/std-agent-planner.ts
-function resolve93(params) {
+function resolve92(params) {
   const entityName = params.entityName ?? "Plan";
   const p = plural(entityName);
   const requiredFields = [
@@ -25081,7 +24999,8 @@ function resolve93(params) {
     { name: "action", type: "string", default: "" },
     { name: "detail", type: "string", default: "" },
     { name: "timestamp", type: "string", default: "" },
-    { name: "duration", type: "number", default: 0 }
+    { name: "duration", type: "number", default: 0 },
+    { name: "icon", type: "string", default: "circle" }
   ];
   const baseFields = ensureIdField(params.fields ?? []);
   const userFieldNames = new Set(baseFields.map((f) => f.name));
@@ -25266,7 +25185,7 @@ function errorView2(_entityName) {
     ]
   };
 }
-function buildTrait72(c) {
+function buildTrait71(c) {
   const { entityName, categories, memoryLimit } = c;
   const categoryList = categories.join(", ");
   return {
@@ -25449,17 +25368,17 @@ function buildTrait72(c) {
     }
   };
 }
-function buildEntity79(c) {
+function buildEntity78(c) {
   return makeEntity({ name: c.entityName, fields: c.fields, persistence: c.persistence });
 }
 function stdAgentPlannerEntity(params) {
-  return buildEntity79(resolve93(params));
+  return buildEntity78(resolve92(params));
 }
 function stdAgentPlannerTrait(params) {
-  return buildTrait72(resolve93(params));
+  return buildTrait71(resolve92(params));
 }
 function stdAgentPlannerPage(params) {
-  const c = resolve93(params);
+  const c = resolve92(params);
   return {
     name: c.pageName,
     path: c.pagePath,
@@ -25467,7 +25386,6 @@ function stdAgentPlannerPage(params) {
     traits: [
       { ref: c.traitName },
       { ref: "PlannerTaskInput" },
-      { ref: "PlannerActivityLog" },
       { ref: "PlannerClassifierFlow" },
       { ref: "PlannerCompletionFlow" },
       { ref: "PlannerMemoryLifecycle" }
@@ -25475,9 +25393,9 @@ function stdAgentPlannerPage(params) {
   };
 }
 function stdAgentPlanner(params) {
-  const c = resolve93(params);
+  const c = resolve92(params);
   const { entityName, fields } = c;
-  const plannerTrait = buildTrait72(c);
+  const plannerTrait = buildTrait71(c);
   const classifierTrait = extractTrait(stdAgentClassifier({
     entityName,
     fields,
@@ -25538,18 +25456,6 @@ function stdAgentPlanner(params) {
     saveEvent: "PLAN"
   }));
   modalTrait.name = "PlannerTaskInput";
-  const activityLogTrait = extractTrait(stdAgentActivityLog({
-    entityName,
-    fields,
-    persistence: "runtime"
-  }));
-  activityLogTrait.name = "PlannerActivityLog";
-  activityLogTrait.listens = [];
-  if (activityLogTrait.emits) {
-    for (const e of activityLogTrait.emits) {
-      e.scope = "internal";
-    }
-  }
   const entity = makeEntity({ name: entityName, fields, persistence: c.persistence });
   const page = {
     name: c.pageName,
@@ -25558,7 +25464,6 @@ function stdAgentPlanner(params) {
     traits: [
       { ref: plannerTrait.name },
       { ref: modalTrait.name },
-      { ref: activityLogTrait.name },
       { ref: classifierTrait.name },
       { ref: completionTrait.name },
       { ref: memoryTrait.name }
@@ -25567,11 +25472,11 @@ function stdAgentPlanner(params) {
   return makeOrbital(
     `${entityName}Orbital`,
     entity,
-    [plannerTrait, modalTrait, activityLogTrait, classifierTrait, completionTrait, memoryTrait],
+    [plannerTrait, modalTrait, classifierTrait, completionTrait, memoryTrait],
     [page]
   );
 }
-function resolve94(params) {
+function resolve93(params) {
   const entityName = params.entityName ?? "ToolCall";
   const p = plural(entityName);
   const requiredFields = [
@@ -25602,7 +25507,7 @@ function resolve94(params) {
     isInitial: params.isInitial ?? false
   };
 }
-function buildEntity80(c) {
+function buildEntity79(c) {
   return makeEntity({ name: c.entityName, fields: c.fields, persistence: c.persistence });
 }
 function buildAgentTrait7(c) {
@@ -25743,26 +25648,25 @@ function buildAgentTrait7(c) {
   };
 }
 function stdAgentToolCallEntity(params = {}) {
-  return buildEntity80(resolve94(params));
+  return buildEntity79(resolve93(params));
 }
 function stdAgentToolCallTrait(params = {}) {
-  return buildAgentTrait7(resolve94(params));
+  return buildAgentTrait7(resolve93(params));
 }
 function stdAgentToolCallPage(params = {}) {
-  const c = resolve94(params);
+  const c = resolve93(params);
   return {
     name: c.pageName,
     path: c.pagePath,
     ...c.isInitial ? { isInitial: true } : {},
     traits: [
       { ref: `${c.entityName}Modal` },
-      { ref: `${c.entityName}Log` },
       { ref: `${c.entityName}Agent` }
     ]
   };
 }
 function stdAgentToolCall(params = {}) {
-  const c = resolve94(params);
+  const c = resolve93(params);
   const { entityName, fields } = c;
   const invokeContent = {
     type: "stack",
@@ -25790,30 +25694,24 @@ function stdAgentToolCall(params = {}) {
     saveEffects: [["persist", "create", entityName, "@payload.data"]],
     emitOnSave: "INVOKED"
   }));
-  const activityLogTrait = extractTrait(stdAgentActivityLog({
-    entityName,
-    fields
-  }));
   const agentTrait = buildAgentTrait7(c);
-  const entity = buildEntity80(c);
+  const entity = buildEntity79(c);
   const page = {
     name: c.pageName,
     path: c.pagePath,
     ...c.isInitial ? { isInitial: true } : {},
     traits: [
       { ref: modalTrait.name },
-      { ref: activityLogTrait.name },
       { ref: agentTrait.name }
     ]
   };
-  return makeOrbital(`${c.entityName}Orbital`, entity, [modalTrait, activityLogTrait, agentTrait], [page]);
+  return makeOrbital(`${c.entityName}Orbital`, entity, [modalTrait, agentTrait], [page]);
 }
-function resolve95(params) {
+function resolve94(params) {
   const entityName = params.entityName ?? "StepTracker";
   const p = plural(entityName);
   const stepLabels = params.stepLabels ?? ["Initialize", "Process", "Validate", "Complete"];
   const requiredFields = [
-    { name: "steps", type: "string", default: stepLabels.join(",") },
     { name: "currentStep", type: "number", default: 0 },
     { name: "totalSteps", type: "number", default: stepLabels.length },
     { name: "status", type: "string", default: "idle" }
@@ -25837,11 +25735,12 @@ function resolve95(params) {
     isInitial: params.isInitial ?? false
   };
 }
-function buildEntity81(c) {
+function buildEntity80(c) {
   return makeEntity({ name: c.entityName, fields: c.fields, persistence: c.persistence });
 }
-function buildTrait73(c) {
+function buildTrait72(c) {
   const { entityName } = c;
+  const stepsLiteral = c.stepLabels.map((label, i) => ({ id: String(i), title: label }));
   const idleUI = {
     type: "stack",
     direction: "vertical",
@@ -25859,7 +25758,7 @@ function buildTrait73(c) {
         ]
       },
       { type: "divider" },
-      { type: "wizard-progress", currentStep: "@entity.currentStep", totalSteps: "@entity.totalSteps", steps: "@entity.steps" },
+      { type: "wizard-progress", currentStep: "@entity.currentStep", steps: stepsLiteral },
       { type: "button", label: "Start", event: "START", variant: "primary", icon: "play" }
     ]
   };
@@ -25880,7 +25779,7 @@ function buildTrait73(c) {
         ]
       },
       { type: "divider" },
-      { type: "wizard-progress", currentStep: "@entity.currentStep", totalSteps: "@entity.totalSteps", steps: "@entity.steps" },
+      { type: "wizard-progress", currentStep: "@entity.currentStep", steps: stepsLiteral },
       {
         type: "stack",
         direction: "horizontal",
@@ -25919,7 +25818,7 @@ function buildTrait73(c) {
         ]
       },
       { type: "divider" },
-      { type: "wizard-progress", currentStep: "@entity.totalSteps", totalSteps: "@entity.totalSteps", steps: "@entity.steps" },
+      { type: "wizard-progress", currentStep: "@entity.totalSteps", steps: stepsLiteral },
       { type: "alert", variant: "success", message: "All steps completed successfully." },
       { type: "button", label: "Reset", event: "RESET", variant: "ghost", icon: "rotate-ccw" }
     ]
@@ -25941,7 +25840,7 @@ function buildTrait73(c) {
         ]
       },
       { type: "divider" },
-      { type: "wizard-progress", currentStep: "@entity.currentStep", totalSteps: "@entity.totalSteps", steps: "@entity.steps" },
+      { type: "wizard-progress", currentStep: "@entity.currentStep", steps: stepsLiteral },
       { type: "alert", variant: "error", message: "Pipeline failed at the current step." },
       {
         type: "stack",
@@ -26076,25 +25975,25 @@ function buildTrait73(c) {
     }
   };
 }
-function buildPage73(c) {
+function buildPage72(c) {
   return makePage({ name: c.pageName, path: c.pagePath, traitName: c.traitName, isInitial: c.isInitial });
 }
 function stdAgentStepProgressEntity(params = {}) {
-  return buildEntity81(resolve95(params));
+  return buildEntity80(resolve94(params));
 }
 function stdAgentStepProgressTrait(params = {}) {
-  return buildTrait73(resolve95(params));
+  return buildTrait72(resolve94(params));
 }
 function stdAgentStepProgressPage(params = {}) {
-  return buildPage73(resolve95(params));
+  return buildPage72(resolve94(params));
 }
 function stdAgentStepProgress(params = {}) {
-  const c = resolve95(params);
-  return makeOrbital(`${c.entityName}Orbital`, buildEntity81(c), [buildTrait73(c)], [buildPage73(c)]);
+  const c = resolve94(params);
+  return makeOrbital(`${c.entityName}Orbital`, buildEntity80(c), [buildTrait72(c)], [buildPage72(c)]);
 }
 
 // behaviors/functions/molecules/std-agent-tool-loop.ts
-function resolve96(params) {
+function resolve95(params) {
   const entityName = params.entityName ?? "ToolLoop";
   const p = plural(entityName);
   const requiredFields = [
@@ -26292,7 +26191,7 @@ function completedView(_entityName) {
       { type: "divider" },
       {
         type: "simple-grid",
-        columns: 2,
+        cols: 2,
         children: [
           { type: "stat-display", label: "Iterations", value: `@entity.iterations`, icon: "repeat" },
           { type: "stat-display", label: "Status", value: `@entity.status`, icon: "check" }
@@ -26329,7 +26228,7 @@ function failedView(_entityName) {
       { type: "alert", variant: "error", message: `@entity.error` },
       {
         type: "simple-grid",
-        columns: 2,
+        cols: 2,
         children: [
           { type: "stat-display", label: "Iterations Used", value: `@entity.iterations`, icon: "repeat" },
           { type: "stat-display", label: "Max Allowed", value: `@entity.maxIterations`, icon: "shield" }
@@ -26339,7 +26238,7 @@ function failedView(_entityName) {
     ]
   };
 }
-function buildTrait74(c) {
+function buildTrait73(c) {
   const { entityName, maxIterations, compactThreshold } = c;
   return {
     name: c.traitName,
@@ -26550,17 +26449,17 @@ function buildTrait74(c) {
     }
   };
 }
-function buildEntity82(c) {
+function buildEntity81(c) {
   return makeEntity({ name: c.entityName, fields: c.fields, persistence: c.persistence });
 }
 function stdAgentToolLoopEntity(params) {
-  return buildEntity82(resolve96(params));
+  return buildEntity81(resolve95(params));
 }
 function stdAgentToolLoopTrait(params) {
-  return buildTrait74(resolve96(params));
+  return buildTrait73(resolve95(params));
 }
 function stdAgentToolLoopPage(params) {
-  const c = resolve96(params);
+  const c = resolve95(params);
   return {
     name: c.pageName,
     path: c.pagePath,
@@ -26568,7 +26467,6 @@ function stdAgentToolLoopPage(params) {
     traits: [
       { ref: c.traitName },
       { ref: "ToolLoopStepProgress" },
-      { ref: "ToolLoopActivityLog" },
       { ref: "ToolLoopCompletionFlow" },
       { ref: "ToolLoopToolCallFlow" },
       { ref: "ToolLoopContextMonitor" }
@@ -26576,9 +26474,9 @@ function stdAgentToolLoopPage(params) {
   };
 }
 function stdAgentToolLoop(params) {
-  const c = resolve96(params);
+  const c = resolve95(params);
   const { entityName, fields } = c;
-  const loopTrait = buildTrait74(c);
+  const loopTrait = buildTrait73(c);
   const completionTrait = extractTrait(stdAgentCompletion({
     entityName,
     fields,
@@ -26628,18 +26526,6 @@ function stdAgentToolLoop(params) {
       e.scope = "internal";
     }
   }
-  const activityLogTrait = extractTrait(stdAgentActivityLog({
-    entityName,
-    fields,
-    persistence: "runtime"
-  }));
-  activityLogTrait.name = "ToolLoopActivityLog";
-  activityLogTrait.listens = [];
-  if (activityLogTrait.emits) {
-    for (const e of activityLogTrait.emits) {
-      e.scope = "internal";
-    }
-  }
   const entity = makeEntity({ name: entityName, fields, persistence: c.persistence });
   const page = {
     name: c.pageName,
@@ -26648,7 +26534,6 @@ function stdAgentToolLoop(params) {
     traits: [
       { ref: loopTrait.name },
       { ref: stepProgressTrait.name },
-      { ref: activityLogTrait.name },
       { ref: completionTrait.name },
       { ref: toolCallTrait.name },
       { ref: contextTrait.name }
@@ -26657,11 +26542,11 @@ function stdAgentToolLoop(params) {
   return makeOrbital(
     `${entityName}Orbital`,
     entity,
-    [loopTrait, stepProgressTrait, activityLogTrait, completionTrait, toolCallTrait, contextTrait],
+    [loopTrait, stepProgressTrait, completionTrait, toolCallTrait, contextTrait],
     [page]
   );
 }
-function resolve97(params) {
+function resolve96(params) {
   const entityName = params.entityName ?? "FixLoop";
   const p = plural(entityName);
   const requiredFields = [
@@ -26857,7 +26742,7 @@ function succeededView() {
       { type: "divider" },
       {
         type: "simple-grid",
-        columns: 2,
+        cols: 2,
         children: [
           { type: "stat-display", label: "Fix Attempts", value: `@entity.fixAttempts`, icon: "wrench" },
           { type: "stat-display", label: "Status", value: "Passed", icon: "check" }
@@ -26890,7 +26775,7 @@ function failedView2() {
       { type: "alert", variant: "error", message: `@entity.error` },
       {
         type: "simple-grid",
-        columns: 2,
+        cols: 2,
         children: [
           { type: "stat-display", label: "Attempts Used", value: `@entity.fixAttempts`, icon: "wrench" },
           { type: "stat-display", label: "Remaining Errors", value: `@entity.errorCount`, icon: "alert-triangle" }
@@ -26912,7 +26797,7 @@ function failedView2() {
     ]
   };
 }
-function buildTrait75(c) {
+function buildTrait74(c) {
   const { entityName, maxAttempts, validateTool, fixTool } = c;
   return {
     name: c.traitName,
@@ -27106,17 +26991,17 @@ function buildTrait75(c) {
     }
   };
 }
-function buildEntity83(c) {
+function buildEntity82(c) {
   return makeEntity({ name: c.entityName, fields: c.fields, persistence: c.persistence });
 }
 function stdAgentFixLoopEntity(params) {
-  return buildEntity83(resolve97(params));
+  return buildEntity82(resolve96(params));
 }
 function stdAgentFixLoopTrait(params) {
-  return buildTrait75(resolve97(params));
+  return buildTrait74(resolve96(params));
 }
 function stdAgentFixLoopPage(params) {
-  const c = resolve97(params);
+  const c = resolve96(params);
   return {
     name: c.pageName,
     path: c.pagePath,
@@ -27132,9 +27017,9 @@ function stdAgentFixLoopPage(params) {
   };
 }
 function stdAgentFixLoop(params) {
-  const c = resolve97(params);
+  const c = resolve96(params);
   const { entityName, fields } = c;
-  const fixTrait = buildTrait75(c);
+  const fixTrait = buildTrait74(c);
   const validateCallTrait = extractTrait(stdAgentToolCall({
     entityName,
     fields,
@@ -27217,7 +27102,7 @@ function stdAgentFixLoop(params) {
     [page]
   );
 }
-function resolve98(params) {
+function resolve97(params) {
   const entityName = params.entityName ?? "Session";
   const p = plural(entityName);
   const requiredFields = [
@@ -27244,7 +27129,7 @@ function resolve98(params) {
     isInitial: params.isInitial ?? false
   };
 }
-function buildEntity84(c) {
+function buildEntity83(c) {
   return makeEntity({ name: c.entityName, fields: c.fields, persistence: c.persistence });
 }
 function buildAgentTrait8(c) {
@@ -27397,13 +27282,13 @@ function buildAgentTrait8(c) {
   };
 }
 function stdAgentSessionEntity(params = {}) {
-  return buildEntity84(resolve98(params));
+  return buildEntity83(resolve97(params));
 }
 function stdAgentSessionTrait(params = {}) {
-  return buildAgentTrait8(resolve98(params));
+  return buildAgentTrait8(resolve97(params));
 }
 function stdAgentSessionPage(params = {}) {
-  const c = resolve98(params);
+  const c = resolve97(params);
   return {
     name: c.pageName,
     path: c.pagePath,
@@ -27416,7 +27301,7 @@ function stdAgentSessionPage(params = {}) {
   };
 }
 function stdAgentSession(params = {}) {
-  const c = resolve98(params);
+  const c = resolve97(params);
   const { entityName, fields } = c;
   const browseTrait = extractTrait(stdBrowse({
     entityName,
@@ -27475,7 +27360,7 @@ function stdAgentSession(params = {}) {
     emitOnSave: "LABELED"
   }));
   const agentTrait = buildAgentTrait8(c);
-  const entity = buildEntity84(c);
+  const entity = buildEntity83(c);
   const page = {
     name: c.pageName,
     path: c.pagePath,
@@ -27614,7 +27499,7 @@ function stdAgentBuilder(params = {}) {
     fix: "wrench"
   }));
 }
-function resolve99(params) {
+function resolve98(params) {
   const entityName = params.entityName ?? "SearchResult";
   const p = plural(entityName);
   const requiredFields = [
@@ -27640,7 +27525,7 @@ function resolve99(params) {
     isInitial: params.isInitial ?? false
   };
 }
-function buildEntity85(c) {
+function buildEntity84(c) {
   return makeEntity({ name: c.entityName, fields: c.fields, persistence: c.persistence });
 }
 function buildAgentTrait9(c) {
@@ -27728,13 +27613,13 @@ function buildAgentTrait9(c) {
   };
 }
 function stdAgentSearchEntity(params = {}) {
-  return buildEntity85(resolve99(params));
+  return buildEntity84(resolve98(params));
 }
 function stdAgentSearchTrait(params = {}) {
-  return buildAgentTrait9(resolve99(params));
+  return buildAgentTrait9(resolve98(params));
 }
 function stdAgentSearchPage(params = {}) {
-  const c = resolve99(params);
+  const c = resolve98(params);
   return {
     name: c.pageName,
     path: c.pagePath,
@@ -27746,7 +27631,7 @@ function stdAgentSearchPage(params = {}) {
   };
 }
 function stdAgentSearch(params = {}) {
-  const c = resolve99(params);
+  const c = resolve98(params);
   const { entityName, fields } = c;
   const browseTrait = extractTrait(stdBrowse({
     entityName,
@@ -27767,7 +27652,7 @@ function stdAgentSearch(params = {}) {
     refreshEvents: ["SEARCHED"]
   }));
   const agentTrait = buildAgentTrait9(c);
-  const entity = buildEntity85(c);
+  const entity = buildEntity84(c);
   const page = {
     name: c.pageName,
     path: c.pagePath,
@@ -27781,7 +27666,7 @@ function stdAgentSearch(params = {}) {
 }
 
 // behaviors/functions/molecules/std-agent-rag.ts
-function resolve100(params) {
+function resolve99(params) {
   const entityName = params.entityName ?? "RagRequest";
   const p = plural(entityName);
   const requiredFields = [
@@ -28108,17 +27993,17 @@ function buildRagTrait(c) {
     }
   };
 }
-function buildEntity86(c) {
+function buildEntity85(c) {
   return makeEntity({ name: c.entityName, fields: c.fields, persistence: c.persistence });
 }
 function stdAgentRagEntity(params) {
-  return buildEntity86(resolve100(params));
+  return buildEntity85(resolve99(params));
 }
 function stdAgentRagTrait(params) {
-  return buildRagTrait(resolve100(params));
+  return buildRagTrait(resolve99(params));
 }
 function stdAgentRagPage(params) {
-  const c = resolve100(params);
+  const c = resolve99(params);
   return {
     name: c.pageName,
     path: c.pagePath,
@@ -28133,7 +28018,7 @@ function stdAgentRagPage(params) {
   };
 }
 function stdAgentRag(params) {
-  const c = resolve100(params);
+  const c = resolve99(params);
   const { entityName, fields } = c;
   const ragTrait = buildRagTrait(c);
   const memoryTrait = extractTrait(stdAgentMemory({
@@ -29189,6 +29074,185 @@ function stdAgentTutor(params = {}) {
     concepts: "brain"
   }));
 }
+function resolve100(params) {
+  const entityName = params.entityName ?? "ActivityEntry";
+  const p = plural(entityName);
+  const requiredFields = [
+    { name: "action", type: "string", default: "" },
+    { name: "detail", type: "string", default: "" },
+    { name: "status", type: "string", default: "pending" },
+    { name: "timestamp", type: "string", default: "" },
+    { name: "duration", type: "number", default: 0 },
+    { name: "icon", type: "string", default: "circle" }
+  ];
+  const baseFields = params.fields ?? [];
+  const existingNames = new Set(baseFields.map((f) => f.name));
+  const mergedFields = [
+    ...baseFields,
+    ...requiredFields.filter((f) => !existingNames.has(f.name))
+  ];
+  const fields = ensureIdField(mergedFields);
+  return {
+    entityName,
+    fields,
+    persistence: params.persistence ?? "persistent",
+    traitName: `${entityName}Log`,
+    pluralName: p,
+    pageName: params.pageName ?? `${entityName}Page`,
+    pagePath: params.pagePath ?? `/${p.toLowerCase()}`,
+    isInitial: params.isInitial ?? false
+  };
+}
+function buildEntity86(c) {
+  return makeEntity({ name: c.entityName, fields: c.fields, persistence: c.persistence });
+}
+function buildTrait75(c) {
+  const { entityName } = c;
+  const loggingUI = {
+    type: "stack",
+    direction: "vertical",
+    gap: "lg",
+    children: [
+      {
+        type: "stack",
+        direction: "horizontal",
+        gap: "sm",
+        justify: "space-between",
+        align: "center",
+        children: [
+          {
+            type: "stack",
+            direction: "horizontal",
+            gap: "sm",
+            align: "center",
+            children: [
+              { type: "icon", name: "activity", size: "lg" },
+              { type: "typography", content: "Activity Log", variant: "h2" }
+            ]
+          },
+          { type: "button", label: "Clear", event: "CLEAR", variant: "ghost", icon: "trash" }
+        ]
+      },
+      { type: "divider" },
+      {
+        type: "timeline",
+        entity: entityName,
+        emptyIcon: "activity",
+        emptyTitle: "No activity yet",
+        emptyDescription: "Agent actions will appear here as they occur.",
+        renderItem: ["fn", "item", {
+          type: "stack",
+          direction: "vertical",
+          gap: "xs",
+          children: [
+            {
+              type: "stack",
+              direction: "horizontal",
+              gap: "sm",
+              align: "center",
+              children: [
+                { type: "badge", label: "@item.status" },
+                { type: "typography", variant: "h4", content: "@item.action" }
+              ]
+            },
+            { type: "typography", variant: "body", color: "muted", content: "@item.detail" },
+            {
+              type: "stack",
+              direction: "horizontal",
+              gap: "sm",
+              align: "center",
+              children: [
+                { type: "typography", variant: "caption", color: "muted", content: "@item.timestamp" },
+                { type: "badge", label: "@item.duration", variant: "outline" }
+              ]
+            }
+          ]
+        }]
+      }
+    ]
+  };
+  return {
+    name: c.traitName,
+    linkedEntity: entityName,
+    category: "interaction",
+    emits: [
+      { event: "LOG_ENTRY", scope: "external", payload: [
+        { name: "action", type: "string" },
+        { name: "detail", type: "string" },
+        { name: "status", type: "string" }
+      ] }
+    ],
+    listens: [
+      { event: "LOG_ENTRY", triggers: "LOG_ENTRY", scope: "external" }
+    ],
+    stateMachine: {
+      states: [
+        { name: "logging", isInitial: true }
+      ],
+      events: [
+        { key: "INIT", name: "Initialize" },
+        { key: "LOG_ENTRY", name: "Log Entry", payload: [
+          { name: "action", type: "string", required: true },
+          { name: "detail", type: "string", required: true },
+          { name: "status", type: "string", required: true }
+        ] },
+        { key: "CLEAR", name: "Clear Log" }
+      ],
+      transitions: [
+        {
+          from: "logging",
+          to: "logging",
+          event: "INIT",
+          effects: [
+            ["fetch", entityName],
+            ["render-ui", "main", loggingUI]
+          ]
+        },
+        {
+          from: "logging",
+          to: "logging",
+          event: "LOG_ENTRY",
+          effects: [
+            ["persist", "create", entityName, {
+              action: "@payload.action",
+              detail: "@payload.detail",
+              status: "@payload.status",
+              timestamp: "@now"
+            }],
+            ["fetch", entityName],
+            ["render-ui", "main", loggingUI]
+          ]
+        },
+        {
+          from: "logging",
+          to: "logging",
+          event: "CLEAR",
+          effects: [
+            ["persist", "delete", entityName],
+            ["fetch", entityName],
+            ["render-ui", "main", loggingUI]
+          ]
+        }
+      ]
+    }
+  };
+}
+function buildPage73(c) {
+  return makePage({ name: c.pageName, path: c.pagePath, traitName: c.traitName, isInitial: c.isInitial });
+}
+function stdAgentActivityLogEntity(params = {}) {
+  return buildEntity86(resolve100(params));
+}
+function stdAgentActivityLogTrait(params = {}) {
+  return buildTrait75(resolve100(params));
+}
+function stdAgentActivityLogPage(params = {}) {
+  return buildPage73(resolve100(params));
+}
+function stdAgentActivityLog(params = {}) {
+  const c = resolve100(params);
+  return makeOrbital(`${c.entityName}Orbital`, buildEntity86(c), [buildTrait75(c)], [buildPage73(c)]);
+}
 function resolve101(params) {
   const entityName = params.entityName ?? "LearningRecord";
   const p = plural(entityName);
@@ -29219,7 +29283,8 @@ function resolve101(params) {
     { name: "action", type: "string", default: "" },
     { name: "detail", type: "string", default: "" },
     { name: "timestamp", type: "string", default: "" },
-    { name: "duration", type: "number", default: 0 }
+    { name: "duration", type: "number", default: 0 },
+    { name: "icon", type: "string", default: "circle" }
   ];
   const baseFields = ensureIdField(params.fields ?? []);
   const userFieldNames = new Set(baseFields.map((f) => f.name));
@@ -29259,7 +29324,7 @@ function idleView5(_entityName) {
       { type: "divider" },
       {
         type: "simple-grid",
-        columns: 3,
+        cols: 3,
         children: [
           { type: "stat-display", label: "Successes", value: `@entity.totalSuccesses`, icon: "check-circle" },
           { type: "stat-display", label: "Failures", value: `@entity.totalFailures`, icon: "x-circle" },
@@ -29533,7 +29598,6 @@ function stdAgentLearnerPage(params) {
     ...c.isInitial ? { isInitial: true } : {},
     traits: [
       { ref: c.traitName },
-      { ref: "LearnerActivityLog" },
       { ref: "LearnerRecordsBrowse" },
       { ref: "LearnerMemoryLifecycle" },
       { ref: "LearnerCompletionFlow" },
@@ -29581,18 +29645,6 @@ function stdAgentLearner(params) {
       e.scope = "internal";
     }
   }
-  const activityLogTrait = extractTrait(stdAgentActivityLog({
-    entityName,
-    fields,
-    persistence: "runtime"
-  }));
-  activityLogTrait.name = "LearnerActivityLog";
-  activityLogTrait.listens = [];
-  if (activityLogTrait.emits) {
-    for (const e of activityLogTrait.emits) {
-      e.scope = "internal";
-    }
-  }
   const recordsBrowseTrait = extractTrait(stdBrowse({
     entityName,
     fields,
@@ -29612,7 +29664,6 @@ function stdAgentLearner(params) {
     ...c.isInitial ? { isInitial: true } : {},
     traits: [
       { ref: learnerTrait.name },
-      { ref: activityLogTrait.name },
       { ref: recordsBrowseTrait.name },
       { ref: memoryTrait.name },
       { ref: completionTrait.name },
@@ -29622,7 +29673,7 @@ function stdAgentLearner(params) {
   return makeOrbital(
     `${entityName}Orbital`,
     entity,
-    [learnerTrait, activityLogTrait, recordsBrowseTrait, memoryTrait, completionTrait, providerTrait],
+    [learnerTrait, recordsBrowseTrait, memoryTrait, completionTrait, providerTrait],
     [page]
   );
 }
@@ -32393,6 +32444,12 @@ var MODULE_DESCRIPTIONS = {
     displayName: "Agent Intelligence",
     description: "Agent memory management, LLM access, tool invocation, context management, and session control.",
     icon: "\u{1F916}"
+  },
+  composition: {
+    name: "Composition",
+    displayName: "Behavior Composition",
+    description: "Compile-time operators for composing N orbitals into a single application schema.",
+    icon: "\u{1F9E9}"
   }
 };
 var BEHAVIOR_GROUPINGS = {