@dudousxd/nestjs-agent-core 0.40.0 → 0.42.0

package/dist/index.cjs

@@ -69,6 +69,8 @@ __export(src_exports, {
   DEFAULT_MAX_SKILLS: () => DEFAULT_MAX_SKILLS,
   DEFAULT_REFUSAL_REASON: () => DEFAULT_REFUSAL_REASON,
   DEFAULT_STRUCTURED_OUTPUT_INSTRUCTION: () => DEFAULT_STRUCTURED_OUTPUT_INSTRUCTION,
+  DEFAULT_TEXT_ACTION_PROPOSAL_REPLIES: () => DEFAULT_TEXT_ACTION_PROPOSAL_REPLIES,
+  DEFAULT_TEXT_ACTION_PROPOSAL_VOCABULARY: () => DEFAULT_TEXT_ACTION_PROPOSAL_VOCABULARY,
   DEFAULT_TOOL_TRANSIENT_RETRY_ATTEMPTS: () => DEFAULT_TOOL_TRANSIENT_RETRY_ATTEMPTS,
   DEFAULT_TOOL_TRANSIENT_RETRY_BACKOFF_MS: () => DEFAULT_TOOL_TRANSIENT_RETRY_BACKOFF_MS,
   DefaultApprovalPolicy: () => DefaultApprovalPolicy,
@@ -126,12 +128,13 @@ __export(src_exports, {
   buildSkillsBlock: () => buildSkillsBlock,
   canActorUseTool: () => canActorUseTool,
   canonicalActionProposalJson: () => canonicalActionProposalJson,
-  canonicalJson: () => canonicalJson,
+  canonicalJson: () => canonicalJson2,
   claimActionProposalOutcome: () => claimActionProposalOutcome,
   closeEmptyRoles: () => closeEmptyRoles,
   compositeSkillProvider: () => compositeSkillProvider,
   confirmTokenExpiry: () => confirmTokenExpiry,
   createFrameBuffer: () => createFrameBuffer,
+  createFunctionalTool: () => createFunctionalTool,
   createIncrementalGate: () => createIncrementalGate,
   createNegotiatedUiCollector: () => createNegotiatedUiCollector,
   createNoopEmitUi: () => createNoopEmitUi,
@@ -145,6 +148,7 @@ __export(src_exports, {
   detachedDelivered: () => detachedDelivered,
   detachedStarted: () => detachedStarted,
   detachedUnsettled: () => detachedUnsettled,
+  emitToolPresentations: () => emitToolPresentations,
   encodeStreamEvent: () => encodeStreamEvent,
   escapeUnsafeToolUiText: () => escapeUnsafeToolUiText,
   estimateCost: () => estimateCost,
@@ -183,6 +187,7 @@ __export(src_exports, {
   parseTextActionProposalCommand: () => parseTextActionProposalCommand,
   personaCatalogEntry: () => personaCatalogEntry,
   prepareActionProposal: () => prepareActionProposal,
+  ptBrActionProposalText: () => ptBrActionProposalText,
   publishAgentDelegated: () => publishAgentDelegated,
   publishAgentMemoryResolved: () => publishAgentMemoryResolved,
   publishAgentMemoryWritten: () => publishAgentMemoryWritten,
@@ -239,6 +244,9 @@ __export(src_exports, {
   streamFailure: () => streamFailure,
   summarizeWithModel: () => summarizeWithModel,
   tenantScope: () => tenantScope,
+  textActionProposalReply: () => textActionProposalReply,
+  toActionProposalMutationView: () => toActionProposalMutationView,
+  toActionProposalView: () => toActionProposalView,
   toolCallApprovalFromRow: () => toolCallApprovalFromRow,
   toolCallContext: () => toolCallContext,
   traceLlmTurn: () => traceLlmTurn,
@@ -800,37 +808,37 @@ async function mayDecideApproval(policy, actor, decision) {
   return defaultCanDecide(actor, decision);
 }
 __name(mayDecideApproval, "mayDecideApproval");
-function toolCallApprovalFromRow(row) {
-  if (row.approver === null || row.approver === void 0) {
+function toolCallApprovalFromRow(row2) {
+  if (row2.approver === null || row2.approver === void 0) {
     return null;
   }
-  const status = row.status === "pending_approval" || row.status === "proposed" ? "pending" : row.status === "rejected" ? "rejected" : row.status === "expired" ? "expired" : "approved";
-  const expiresAt = row.expiresAt instanceof Date ? row.expiresAt.toISOString() : typeof row.expiresAt === "string" ? row.expiresAt : void 0;
+  const status = row2.status === "pending_approval" || row2.status === "proposed" ? "pending" : row2.status === "rejected" ? "rejected" : row2.status === "expired" ? "expired" : "approved";
+  const expiresAt = row2.expiresAt instanceof Date ? row2.expiresAt.toISOString() : typeof row2.expiresAt === "string" ? row2.expiresAt : void 0;
   const decided = status === "approved" || status === "rejected";
   return {
-    toolCallId: row.toolCallId,
-    ...row.proposalId != null ? {
-      proposalId: row.proposalId
+    toolCallId: row2.toolCallId,
+    ...row2.proposalId != null ? {
+      proposalId: row2.proposalId
     } : {},
-    approver: row.approver,
-    ...row.confirmation != null ? {
-      confirmation: row.confirmation
+    approver: row2.approver,
+    ...row2.confirmation != null ? {
+      confirmation: row2.confirmation
     } : {},
     status,
     ...expiresAt !== void 0 ? {
       expiresAt
     } : {},
-    ...row.remember === true ? {
+    ...row2.remember === true ? {
       remember: true
     } : {},
-    ...decided && typeof row.executedByRef === "string" ? {
-      decidedBy: row.executedByRef
+    ...decided && typeof row2.executedByRef === "string" ? {
+      decidedBy: row2.executedByRef
     } : {},
-    ...decided && typeof row.decidedVia === "string" ? {
-      decidedVia: row.decidedVia
+    ...decided && typeof row2.decidedVia === "string" ? {
+      decidedVia: row2.decidedVia
     } : {},
-    ...status === "rejected" && typeof row.error === "string" ? {
-      reason: row.error
+    ...status === "rejected" && typeof row2.error === "string" ? {
+      reason: row2.error
     } : {}
   };
 }
@@ -847,24 +855,24 @@ function estimateCost(usage, price) {
   return uncachedInputTokens / 1e6 * price.inputPricePer1m + cacheWriteTokens / 1e6 * (price.cacheWritePricePer1m ?? price.inputPricePer1m) + cacheReadTokens / 1e6 * (price.cacheReadPricePer1m ?? price.inputPricePer1m) + usage.outputTokens / 1e6 * price.outputPricePer1m;
 }
 __name(estimateCost, "estimateCost");
-function rowCost(row, prices) {
-  return row.costUsd ?? estimateCost(row, prices.get(row.modelId));
+function rowCost(row2, prices) {
+  return row2.costUsd ?? estimateCost(row2, prices.get(row2.modelId));
 }
 __name(rowCost, "rowCost");
 function bucketByModel(rows, prices) {
   const byModel = /* @__PURE__ */ new Map();
-  for (const row of rows) {
-    const bucket = byModel.get(row.modelId) ?? {
+  for (const row2 of rows) {
+    const bucket = byModel.get(row2.modelId) ?? {
       requests: 0,
       inputTokens: 0,
       outputTokens: 0,
       costUsd: 0
     };
     bucket.requests += 1;
-    bucket.inputTokens += row.inputTokens;
-    bucket.outputTokens += row.outputTokens;
-    bucket.costUsd += rowCost(row, prices);
-    byModel.set(row.modelId, bucket);
+    bucket.inputTokens += row2.inputTokens;
+    bucket.outputTokens += row2.outputTokens;
+    bucket.costUsd += rowCost(row2, prices);
+    byModel.set(row2.modelId, bucket);
   }
   const result2 = [];
   for (const [modelId, bucket] of byModel) {
@@ -882,18 +890,18 @@ function bucketByModel(rows, prices) {
 __name(bucketByModel, "bucketByModel");
 function bucketByActor(rows, prices) {
   const byActor = /* @__PURE__ */ new Map();
-  for (const row of rows) {
-    const bucket = byActor.get(row.actorRef) ?? {
+  for (const row2 of rows) {
+    const bucket = byActor.get(row2.actorRef) ?? {
       requests: 0,
       totalTokens: 0,
       costUsd: 0,
       threadIds: /* @__PURE__ */ new Set()
     };
     bucket.requests += 1;
-    bucket.totalTokens += row.inputTokens + row.outputTokens;
-    bucket.costUsd += rowCost(row, prices);
-    bucket.threadIds.add(row.threadId);
-    byActor.set(row.actorRef, bucket);
+    bucket.totalTokens += row2.inputTokens + row2.outputTokens;
+    bucket.costUsd += rowCost(row2, prices);
+    bucket.threadIds.add(row2.threadId);
+    byActor.set(row2.actorRef, bucket);
   }
   const result2 = [];
   for (const [actorRef, bucket] of byActor) {
@@ -911,16 +919,16 @@ function bucketByActor(rows, prices) {
 __name(bucketByActor, "bucketByActor");
 function bucketByThread(rows, prices, threads, options) {
   const byThread = /* @__PURE__ */ new Map();
-  for (const row of rows) {
-    const bucket = byThread.get(row.threadId) ?? {
+  for (const row2 of rows) {
+    const bucket = byThread.get(row2.threadId) ?? {
       requests: 0,
       totalTokens: 0,
       costUsd: 0
     };
     bucket.requests += 1;
-    bucket.totalTokens += row.inputTokens + row.outputTokens;
-    bucket.costUsd += rowCost(row, prices);
-    byThread.set(row.threadId, bucket);
+    bucket.totalTokens += row2.inputTokens + row2.outputTokens;
+    bucket.costUsd += rowCost(row2, prices);
+    byThread.set(row2.threadId, bucket);
   }
   const result2 = [];
   for (const [threadId, bucket] of byThread) {
@@ -949,26 +957,26 @@ function rollupThreadUsage(rows, prices) {
     totalTokens: 0,
     costUsd: 0
   };
-  for (const row of rows) {
+  for (const row2 of rows) {
     rollup.requests += 1;
-    rollup.inputTokens += row.inputTokens;
-    rollup.outputTokens += row.outputTokens;
-    rollup.totalTokens += row.inputTokens + row.outputTokens;
-    rollup.costUsd += rowCost(row, prices);
+    rollup.inputTokens += row2.inputTokens;
+    rollup.outputTokens += row2.outputTokens;
+    rollup.totalTokens += row2.inputTokens + row2.outputTokens;
+    rollup.costUsd += rowCost(row2, prices);
   }
   return rollup;
 }
 __name(rollupThreadUsage, "rollupThreadUsage");
 function bucketUsageTrend(rows, prices) {
   const byDay = /* @__PURE__ */ new Map();
-  for (const row of rows) {
-    const bucket = byDay.get(row.day) ?? {
+  for (const row2 of rows) {
+    const bucket = byDay.get(row2.day) ?? {
       totalTokens: 0,
       costUsd: 0
     };
-    bucket.totalTokens += row.inputTokens + row.outputTokens;
-    bucket.costUsd += rowCost(row, prices);
-    byDay.set(row.day, bucket);
+    bucket.totalTokens += row2.inputTokens + row2.outputTokens;
+    bucket.costUsd += rowCost(row2, prices);
+    byDay.set(row2.day, bucket);
   }
   const result2 = [];
   for (const [day, bucket] of byDay) {
@@ -1004,7 +1012,7 @@ async function filterToolsByEnabled(entries) {
     entry,
     enabled: await isToolEnabled(entry.spec, entry.handler)
   })));
-  return checked.filter((row) => row.enabled).map((row) => row.entry);
+  return checked.filter((row2) => row2.enabled).map((row2) => row2.entry);
 }
 __name(filterToolsByEnabled, "filterToolsByEnabled");
 async function canActorUseTool(actor, handler) {
@@ -1016,7 +1024,7 @@ async function filterToolsByCanUse(entries, actor) {
     entry,
     allowed: await canActorUseTool(actor, entry.handler)
   })));
-  return checked.filter((row) => row.allowed).map((row) => row.entry);
+  return checked.filter((row2) => row2.allowed).map((row2) => row2.entry);
 }
 __name(filterToolsByCanUse, "filterToolsByCanUse");
 async function filterToolsByRole(tools, actor, policy) {
@@ -2916,20 +2924,20 @@ function validateActionProposalDiscoveryIndexBatch(command) {
 __name(validateActionProposalDiscoveryIndexBatch, "validateActionProposalDiscoveryIndexBatch");
 
 // src/action-proposal-outcome.ts
-function attachActionProposalOutcome(row, now, ui = [], text) {
-  if (row.outcome) return row;
-  const execution = row.execution;
+function attachActionProposalOutcome(row2, now, ui = [], text) {
+  if (row2.outcome) return row2;
+  const execution = row2.execution;
   const outcome = {
-    id: `${row.id}:outcome:1`,
-    proposalId: row.id,
+    id: `${row2.id}:outcome:1`,
+    proposalId: row2.id,
     outcomeVersion: 1,
-    tenantRef: row.tenantRef,
-    actorRef: row.actorRef,
-    threadId: row.threadId,
-    originRunId: row.originRunId,
-    originToolCallId: row.originToolCallId,
-    toolName: row.toolName,
-    decision: row.decision,
+    tenantRef: row2.tenantRef,
+    actorRef: row2.actorRef,
+    threadId: row2.threadId,
+    originRunId: row2.originRunId,
+    originToolCallId: row2.originToolCallId,
+    toolName: row2.toolName,
+    decision: row2.decision,
     ui,
     createdAt: now,
     ...text !== void 0 ? {
@@ -2943,12 +2951,12 @@ function attachActionProposalOutcome(row, now, ui = [], text) {
     } : {},
     ...execution?.error !== void 0 ? {
       error: execution.error
-    } : row.decisionAudit?.reason !== void 0 ? {
-      error: row.decisionAudit.reason
+    } : row2.decisionAudit?.reason !== void 0 ? {
+      error: row2.decisionAudit.reason
     } : {}
   };
   return snapshotActionProposal({
-    ...row,
+    ...row2,
     outcome,
     outcomeDelivery: {
       status: "pending",
@@ -2958,13 +2966,13 @@ function attachActionProposalOutcome(row, now, ui = [], text) {
   });
 }
 __name(attachActionProposalOutcome, "attachActionProposalOutcome");
-function claimActionProposalOutcome(row, command, now, token) {
+function claimActionProposalOutcome(row2, command, now, token) {
   validateActionProposalWorkerClaim(command, now);
-  const delivery = row.outcomeDelivery;
-  if (!row.outcome || !delivery || delivery.status !== "pending" || delivery.lease && now < delivery.lease.expiresAt) return null;
+  const delivery = row2.outcomeDelivery;
+  if (!row2.outcome || !delivery || delivery.status !== "pending" || delivery.lease && now < delivery.lease.expiresAt) return null;
   const generation = delivery.generation + 1;
   return snapshotActionProposal({
-    ...row,
+    ...row2,
     outcomeDelivery: {
       ...delivery,
       generation,
@@ -2978,11 +2986,11 @@ function claimActionProposalOutcome(row, command, now, token) {
   });
 }
 __name(claimActionProposalOutcome, "claimActionProposalOutcome");
-function actionProposalOutcomeFenceValid(row, command, now) {
+function actionProposalOutcomeFenceValid(row2, command, now) {
   if (!Number.isSafeInteger(now)) throw new RangeError("Invalid server clock");
   if (typeof command.token !== "string" || !command.token || !Number.isSafeInteger(command.generation) || command.generation < 1 || typeof command.outcomeId !== "string" || !command.outcomeId) throw new TypeError("Invalid outcome fence");
-  const delivery = row.outcomeDelivery;
-  return row.outcome?.id === command.outcomeId && delivery?.status === "pending" && delivery.generation === command.generation && delivery.lease?.token === command.token && delivery.lease.generation === command.generation && now < delivery.lease.expiresAt;
+  const delivery = row2.outcomeDelivery;
+  return row2.outcome?.id === command.outcomeId && delivery?.status === "pending" && delivery.generation === command.generation && delivery.lease?.token === command.token && delivery.lease.generation === command.generation && now < delivery.lease.expiresAt;
 }
 __name(actionProposalOutcomeFenceValid, "actionProposalOutcomeFenceValid");
 function outcomeSummary(outcome) {
@@ -3157,21 +3165,21 @@ function check(schema, value, path, root, issues, depth) {
     });
     return;
   }
-  const s = schema;
-  if (typeof s.$ref === "string") {
-    const target = resolveRef(root, s.$ref);
+  const s2 = schema;
+  if (typeof s2.$ref === "string") {
+    const target = resolveRef(root, s2.$ref);
     if (target === void 0) {
       issues.push({
         path,
-        message: `references unknown schema ${s.$ref}`
+        message: `references unknown schema ${s2.$ref}`
       });
       return;
     }
     check(target, value, path, root, issues, depth + 1);
   }
-  if (s.type !== void 0) {
-    const types = Array.isArray(s.type) ? s.type : [
-      s.type
+  if (s2.type !== void 0) {
+    const types = Array.isArray(s2.type) ? s2.type : [
+      s2.type
     ];
     if (!types.some((type) => matchesType(type, value))) {
       issues.push({
@@ -3181,76 +3189,76 @@ function check(schema, value, path, root, issues, depth) {
       return;
     }
   }
-  if (Array.isArray(s.enum) && !s.enum.some((option) => deepEqual(option, value))) {
+  if (Array.isArray(s2.enum) && !s2.enum.some((option) => deepEqual(option, value))) {
     issues.push({
       path,
-      message: `must be one of ${s.enum.map((option) => JSON.stringify(option)).join(", ")}`
+      message: `must be one of ${s2.enum.map((option) => JSON.stringify(option)).join(", ")}`
     });
   }
-  if ("const" in s && !deepEqual(s.const, value)) {
+  if ("const" in s2 && !deepEqual(s2.const, value)) {
     issues.push({
       path,
-      message: `must be ${JSON.stringify(s.const)}`
+      message: `must be ${JSON.stringify(s2.const)}`
     });
   }
   if (typeof value === "string") {
-    if (typeof s.minLength === "number" && value.length < s.minLength) {
+    if (typeof s2.minLength === "number" && value.length < s2.minLength) {
       issues.push({
         path,
-        message: `must be at least ${s.minLength} characters`
+        message: `must be at least ${s2.minLength} characters`
       });
     }
-    if (typeof s.maxLength === "number" && value.length > s.maxLength) {
+    if (typeof s2.maxLength === "number" && value.length > s2.maxLength) {
       issues.push({
         path,
-        message: `must be at most ${s.maxLength} characters`
+        message: `must be at most ${s2.maxLength} characters`
       });
     }
-    if (typeof s.pattern === "string") {
+    if (typeof s2.pattern === "string") {
       let pattern;
       try {
-        pattern = new RegExp(s.pattern, "u");
+        pattern = new RegExp(s2.pattern, "u");
       } catch {
         pattern = void 0;
       }
       if (pattern !== void 0 && !pattern.test(value)) {
         issues.push({
           path,
-          message: `must match ${s.pattern}`
+          message: `must match ${s2.pattern}`
         });
       }
     }
   }
   if (typeof value === "number") {
-    if (typeof s.minimum === "number" && value < s.minimum) {
+    if (typeof s2.minimum === "number" && value < s2.minimum) {
       issues.push({
         path,
-        message: `must be >= ${s.minimum}`
+        message: `must be >= ${s2.minimum}`
       });
     }
-    if (typeof s.maximum === "number" && value > s.maximum) {
+    if (typeof s2.maximum === "number" && value > s2.maximum) {
       issues.push({
         path,
-        message: `must be <= ${s.maximum}`
+        message: `must be <= ${s2.maximum}`
       });
     }
   }
   if (Array.isArray(value)) {
-    if (typeof s.minItems === "number" && value.length < s.minItems) {
+    if (typeof s2.minItems === "number" && value.length < s2.minItems) {
       issues.push({
         path,
-        message: `must have at least ${s.minItems} items`
+        message: `must have at least ${s2.minItems} items`
       });
     }
-    if (typeof s.maxItems === "number" && value.length > s.maxItems) {
+    if (typeof s2.maxItems === "number" && value.length > s2.maxItems) {
       issues.push({
         path,
-        message: `must have at most ${s.maxItems} items`
+        message: `must have at most ${s2.maxItems} items`
       });
     }
-    if (s.items !== void 0 && !Array.isArray(s.items)) {
+    if (s2.items !== void 0 && !Array.isArray(s2.items)) {
       value.forEach((item, index) => {
-        check(s.items, item, [
+        check(s2.items, item, [
           ...path,
           index
         ], root, issues, depth + 1);
@@ -3259,9 +3267,9 @@ function check(schema, value, path, root, issues, depth) {
   }
   if (matchesType("object", value)) {
     const record2 = value;
-    const properties = typeof s.properties === "object" && s.properties !== null ? s.properties : {};
-    if (Array.isArray(s.required)) {
-      for (const key of s.required) {
+    const properties = typeof s2.properties === "object" && s2.properties !== null ? s2.properties : {};
+    if (Array.isArray(s2.required)) {
+      for (const key of s2.required) {
         if (record2[key] === void 0) {
           issues.push({
             path: [
@@ -3281,7 +3289,7 @@ function check(schema, value, path, root, issues, depth) {
             key
           ], root, issues, depth + 1);
         }
-      } else if (s.additionalProperties === false) {
+      } else if (s2.additionalProperties === false) {
         issues.push({
           path: [
             ...path,
@@ -3289,34 +3297,34 @@ function check(schema, value, path, root, issues, depth) {
           ],
           message: "is not a known property"
         });
-      } else if (typeof s.additionalProperties === "object" && s.additionalProperties !== null) {
-        check(s.additionalProperties, entry, [
+      } else if (typeof s2.additionalProperties === "object" && s2.additionalProperties !== null) {
+        check(s2.additionalProperties, entry, [
           ...path,
           key
         ], root, issues, depth + 1);
       }
     }
   }
-  if (Array.isArray(s.allOf)) {
-    for (const sub of s.allOf) check(sub, value, path, root, issues, depth + 1);
+  if (Array.isArray(s2.allOf)) {
+    for (const sub of s2.allOf) check(sub, value, path, root, issues, depth + 1);
   }
-  if (Array.isArray(s.anyOf) || Array.isArray(s.oneOf)) {
-    const options = Array.isArray(s.anyOf) ? s.anyOf : s.oneOf;
+  if (Array.isArray(s2.anyOf) || Array.isArray(s2.oneOf)) {
+    const options = Array.isArray(s2.anyOf) ? s2.anyOf : s2.oneOf;
     const passing = options.filter((sub) => {
       const nested = [];
       check(sub, value, path, root, nested, depth + 1);
       return nested.length === 0;
     }).length;
-    if (Array.isArray(s.anyOf) ? passing === 0 : passing !== 1) {
+    if (Array.isArray(s2.anyOf) ? passing === 0 : passing !== 1) {
       issues.push({
         path,
-        message: Array.isArray(s.anyOf) ? "does not match any allowed shape" : "must match exactly one allowed shape"
+        message: Array.isArray(s2.anyOf) ? "does not match any allowed shape" : "must match exactly one allowed shape"
       });
     }
   }
-  if (s.not !== void 0) {
+  if (s2.not !== void 0) {
     const nested = [];
-    check(s.not, value, path, root, nested, depth + 1);
+    check(s2.not, value, path, root, nested, depth + 1);
     if (nested.length === 0) {
       issues.push({
         path,
@@ -3373,7 +3381,7 @@ function buildCatalog(byName, validator) {
           ]
         };
       }
-      const result2 = await validateProps(definition.props, props, validator);
+      const result2 = await validateProps(definition.outputProps ?? definition.props, props, validator);
       return result2;
     },
     validateSync(component, props) {
@@ -3389,11 +3397,11 @@ function buildCatalog(byName, validator) {
           ]
         };
       }
-      return validatePropsSync(definition.props, props, validator);
+      return validatePropsSync(definition.outputProps ?? definition.props, props, validator);
     },
     jsonSchemaFor(component) {
       const definition = byName.get(component);
-      return definition === void 0 ? void 0 : toJsonSchema(definition.props);
+      return definition === void 0 ? void 0 : toJsonSchema(definition.outputProps ?? definition.props);
     },
     extend(more) {
       const next = new Map(byName);
@@ -3409,7 +3417,7 @@ __name(buildCatalog, "buildCatalog");
 
 // src/genui/tree.ts
 var GENUI_TREE_COMPONENT = "genui:tree";
-async function validateTree(catalog, tree, limits = {}) {
+async function validateTree(catalog, tree, limits = {}, phase = "output") {
   const maxDepth = limits.maxDepth ?? 12;
   const maxNodes = limits.maxNodes ?? 200;
   const issues = [];
@@ -3461,7 +3469,7 @@ async function validateTree(catalog, tree, limits = {}) {
       });
       return void 0;
     }
-    const validated = await catalog.validate(element.type, element.props ?? {});
+    const validated = phase === "input" ? await validateProps(definition.props, element.props ?? {}, catalog.validator) : await catalog.validate(element.type, element.props ?? {});
     let props = {};
     if (!validated.ok) {
       for (const issue4 of validated.issues) {
@@ -3821,8 +3829,8 @@ function snapshotActionProposal(value) {
   return JSON.parse(canonicalActionProposalJson(value));
 }
 __name(snapshotActionProposal, "snapshotActionProposal");
-function actionProposalScopeMatches(row, scope) {
-  return row.tenantRef === scope.tenantRef && row.actorRef === scope.actorRef && row.threadId === scope.threadId;
+function actionProposalScopeMatches(row2, scope) {
+  return row2.tenantRef === scope.tenantRef && row2.actorRef === scope.actorRef && row2.threadId === scope.threadId;
 }
 __name(actionProposalScopeMatches, "actionProposalScopeMatches");
 function initialActionProposal(input, now) {
@@ -3838,9 +3846,9 @@ function initialActionProposal(input, now) {
   });
 }
 __name(initialActionProposal, "initialActionProposal");
-function actionProposalCreationMatches(row, input) {
+function actionProposalCreationMatches(row2, input) {
   validateActionProposalCreation(input);
-  const { decision: _decision, decisionAudit: _audit, execution: _execution, createdAt: _created, updatedAt: _updated, supersededBy: _supersededBy, outcome: _outcome, outcomeDelivery: _delivery, ...original } = row;
+  const { decision: _decision, decisionAudit: _audit, execution: _execution, createdAt: _created, updatedAt: _updated, supersededBy: _supersededBy, outcome: _outcome, outcomeDelivery: _delivery, ...original } = row2;
   return canonicalActionProposalJson(original) === canonicalActionProposalJson(input);
 }
 __name(actionProposalCreationMatches, "actionProposalCreationMatches");
@@ -3851,7 +3859,7 @@ function result(status, proposal) {
   };
 }
 __name(result, "result");
-function transitionActionProposalDecision(row, command, now) {
+function transitionActionProposalDecision(row2, command, now) {
   checkTime(now);
   if (![
     "approved",
@@ -3862,11 +3870,11 @@ function transitionActionProposalDecision(row, command, now) {
   checkString(command.via);
   if (command.reason !== void 0 && typeof command.reason !== "string") throw new TypeError("reason must be a string");
   if (command.remember !== void 0 && typeof command.remember !== "boolean") throw new TypeError("remember must be a boolean");
-  if (row.decision !== "pending") {
-    return result(row.decision === command.decision ? "unchanged" : row.decision === "expired" ? "expired" : "conflict", row);
+  if (row2.decision !== "pending") {
+    return result(row2.decision === command.decision ? "unchanged" : row2.decision === "expired" ? "expired" : "conflict", row2);
   }
-  const next = snapshotActionProposal(row);
-  if (row.expiresAt !== null && now >= row.expiresAt) {
+  const next = snapshotActionProposal(row2);
+  if (row2.expiresAt !== null && now >= row2.expiresAt) {
     next.decision = "expired";
     next.decisionAudit = {
       actorRef: "system",
@@ -3876,7 +3884,7 @@ function transitionActionProposalDecision(row, command, now) {
     next.updatedAt = now;
     return result(command.decision === "expired" ? "applied" : "expired", attachActionProposalOutcome(next, now));
   }
-  if (command.decision === "expired") return result("conflict", row);
+  if (command.decision === "expired") return result("conflict", row2);
   const { decision, ...audit } = command;
   next.decision = decision;
   next.decisionAudit = {
@@ -3904,13 +3912,13 @@ function checkLeaseMs(leaseMs, now) {
   if (!Number.isSafeInteger(leaseMs) || leaseMs <= 0 || !Number.isSafeInteger(now + leaseMs)) throw new RangeError("leaseMs must be finite and positive");
 }
 __name(checkLeaseMs, "checkLeaseMs");
-function transitionActionProposalClaim(row, command, now, token) {
+function transitionActionProposalClaim(row2, command, now, token) {
   checkLeaseMs(command.leaseMs, now);
   checkString(command.workerId);
   checkString(token);
-  const execution = row.execution;
-  if (row.decision !== "approved" || !execution || execution.status !== "queued" && !(execution.status === "executing" && execution.lease && now >= execution.lease.expiresAt)) return result("conflict", row);
-  const next = snapshotActionProposal(row);
+  const execution = row2.execution;
+  if (row2.decision !== "approved" || !execution || execution.status !== "queued" && !(execution.status === "executing" && execution.lease && now >= execution.lease.expiresAt)) return result("conflict", row2);
+  const next = snapshotActionProposal(row2);
   const generation = execution.generation + 1;
   next.execution = {
     status: "executing",
@@ -3926,32 +3934,32 @@ function transitionActionProposalClaim(row, command, now, token) {
   return result("applied", next);
 }
 __name(transitionActionProposalClaim, "transitionActionProposalClaim");
-function leaseStatus(row, command, now) {
+function leaseStatus(row2, command, now) {
   checkTime(now);
   checkString(command.token);
   if (!Number.isSafeInteger(command.generation) || command.generation < 1) throw new RangeError("Invalid lease generation");
-  const work = row.execution;
-  if (row.decision !== "approved" || work?.status !== "executing" || !work.lease || work.generation !== command.generation || work.lease.generation !== command.generation || work.lease.token !== command.token) return "conflict";
+  const work = row2.execution;
+  if (row2.decision !== "approved" || work?.status !== "executing" || !work.lease || work.generation !== command.generation || work.lease.generation !== command.generation || work.lease.token !== command.token) return "conflict";
   return now >= work.lease.expiresAt ? "expired" : "valid";
 }
 __name(leaseStatus, "leaseStatus");
-function transitionActionProposalLease(row, command, now) {
+function transitionActionProposalLease(row2, command, now) {
   checkLeaseMs(command.leaseMs, now);
-  const status = leaseStatus(row, command, now);
-  if (status !== "valid") return result(status, row);
-  const next = snapshotActionProposal(row);
+  const status = leaseStatus(row2, command, now);
+  if (status !== "valid") return result(status, row2);
+  const next = snapshotActionProposal(row2);
   if (next.execution?.lease) next.execution.lease.expiresAt = Math.max(next.execution.lease.expiresAt, now + command.leaseMs);
   next.updatedAt = now;
   return result("applied", next);
 }
 __name(transitionActionProposalLease, "transitionActionProposalLease");
-function transitionActionProposalSettlement(row, command, now) {
+function transitionActionProposalSettlement(row2, command, now) {
   checkTime(now);
   if (command.status !== "succeeded" && command.status !== "failed") throw new TypeError("Unsupported settlement status");
   if (command.status === "succeeded" && command.error !== void 0 || command.status === "failed" && (typeof command.error !== "string" || command.result !== void 0)) throw new TypeError("Ambiguous action proposal settlement");
-  const status = leaseStatus(row, command, now);
-  if (status !== "valid") return result(status, row);
-  const next = snapshotActionProposal(row);
+  const status = leaseStatus(row2, command, now);
+  if (status !== "valid") return result(status, row2);
+  const next = snapshotActionProposal(row2);
   next.execution = command.status === "succeeded" ? {
     status: "succeeded",
     generation: command.generation,
@@ -3971,16 +3979,16 @@ function transitionActionProposalSettlement(row, command, now) {
   return result("applied", attachActionProposalOutcome(next, now, command.ui, command.text));
 }
 __name(transitionActionProposalSettlement, "transitionActionProposalSettlement");
-function transitionActionProposalSupersession(row, replacement, command, now) {
+function transitionActionProposalSupersession(row2, replacement, command, now) {
   checkTime(now);
   checkString(command.replacementProposalId);
   checkString(command.actorRef);
   checkString(command.via);
-  if (replacement.id !== command.replacementProposalId || row.id === replacement.id || !actionProposalScopeMatches(row, replacement) || row.toolName !== replacement.toolName || !row.replacementKey || row.replacementKey !== replacement.replacementKey) return result("conflict", row);
-  if (row.decision === "superseded") return result(row.supersededBy === replacement.id ? "unchanged" : "conflict", row);
-  if (row.decision !== "pending") return result("conflict", row);
-  if (row.expiresAt !== null && now >= row.expiresAt) return {
-    ...transitionActionProposalDecision(row, {
+  if (replacement.id !== command.replacementProposalId || row2.id === replacement.id || !actionProposalScopeMatches(row2, replacement) || row2.toolName !== replacement.toolName || !row2.replacementKey || row2.replacementKey !== replacement.replacementKey) return result("conflict", row2);
+  if (row2.decision === "superseded") return result(row2.supersededBy === replacement.id ? "unchanged" : "conflict", row2);
+  if (row2.decision !== "pending") return result("conflict", row2);
+  if (row2.expiresAt !== null && now >= row2.expiresAt) return {
+    ...transitionActionProposalDecision(row2, {
       decision: "expired",
       actorRef: "system",
       via: "expiry"
@@ -3988,7 +3996,7 @@ function transitionActionProposalSupersession(row, replacement, command, now) {
     status: "expired"
   };
   const next = snapshotActionProposal({
-    ...row,
+    ...row2,
     decision: "superseded",
     supersededBy: replacement.id,
     decisionAudit: {
@@ -4003,6 +4011,560 @@ function transitionActionProposalSupersession(row, replacement, command, now) {
 }
 __name(transitionActionProposalSupersession, "transitionActionProposalSupersession");
 
+// src/genui/builtins.ts
+var str = /* @__PURE__ */ __name((description, extra = {}) => ({
+  type: "string",
+  ...description !== void 0 ? {
+    description
+  } : {},
+  ...extra
+}), "str");
+var obj = /* @__PURE__ */ __name((properties, required = []) => ({
+  type: "object",
+  properties,
+  required,
+  additionalProperties: false
+}), "obj");
+var arr = /* @__PURE__ */ __name((items, extra = {}) => ({
+  type: "array",
+  items,
+  ...extra
+}), "arr");
+var cell = {
+  type: [
+    "string",
+    "number",
+    "boolean",
+    "null"
+  ]
+};
+var row = {
+  type: "object",
+  additionalProperties: cell
+};
+var s = /* @__PURE__ */ __name((value) => value === null || value === void 0 ? "" : String(value), "s");
+var heading = /* @__PURE__ */ __name((props) => props.title ? `*${s(props.title)}*
+` : "", "heading");
+function textTable(columns, rows, max = 15) {
+  const shown = rows.slice(0, max);
+  const widths = columns.map((column) => Math.min(28, Math.max(column.label.length, ...shown.map((r) => s(r[column.key]).length))));
+  const format = /* @__PURE__ */ __name((values) => values.map((value, index) => value.slice(0, widths[index]).padEnd(widths[index] ?? 0)).join("  "), "format");
+  const lines = [
+    format(columns.map((column) => column.label)),
+    widths.map((width) => "-".repeat(width)).join("  "),
+    ...shown.map((r) => format(columns.map((column) => s(r[column.key]))))
+  ];
+  if (rows.length > max) lines.push(`\u2026 ${rows.length - max} more rows`);
+  return `\`\`\`
+${lines.join("\n")}
+\`\`\``;
+}
+__name(textTable, "textTable");
+function lineDiff(before, after) {
+  const a = before.split("\n");
+  const b = after.split("\n");
+  if (a.length * b.length > 25e4) {
+    return [
+      ...a.map((text) => ({
+        op: "del",
+        text
+      })),
+      ...b.map((text) => ({
+        op: "add",
+        text
+      }))
+    ];
+  }
+  const dp = Array.from({
+    length: a.length + 1
+  }, () => new Array(b.length + 1).fill(0));
+  const at = /* @__PURE__ */ __name((i2, j2) => dp[i2]?.[j2] ?? 0, "at");
+  for (let i2 = a.length - 1; i2 >= 0; i2--) {
+    for (let j2 = b.length - 1; j2 >= 0; j2--) {
+      dp[i2][j2] = a[i2] === b[j2] ? at(i2 + 1, j2 + 1) + 1 : Math.max(at(i2 + 1, j2), at(i2, j2 + 1));
+    }
+  }
+  const out = [];
+  let i = 0;
+  let j = 0;
+  while (i < a.length && j < b.length) {
+    if (a[i] === b[j]) {
+      out.push({
+        op: "same",
+        text: a[i]
+      });
+      i++;
+      j++;
+    } else if (at(i + 1, j) >= at(i, j + 1)) {
+      out.push({
+        op: "del",
+        text: a[i++]
+      });
+    } else {
+      out.push({
+        op: "add",
+        text: b[j++]
+      });
+    }
+  }
+  while (i < a.length) out.push({
+    op: "del",
+    text: a[i++]
+  });
+  while (j < b.length) out.push({
+    op: "add",
+    text: b[j++]
+  });
+  return out;
+}
+__name(lineDiff, "lineDiff");
+function bar(value, max, width = 20) {
+  const n = max > 0 ? Math.round(Math.abs(value) / max * width) : 0;
+  return "\u2588".repeat(n) || "\u258F";
+}
+__name(bar, "bar");
+var DataTable = defineComponent({
+  name: "DataTable",
+  title: "Data table",
+  description: "Tabular data (records with the same fields) as a sortable table. Prefer it over markdown tables for more than 3 rows.",
+  props: obj({
+    title: str("Short caption"),
+    columns: arr(obj({
+      key: str("Field name in each row"),
+      label: str("Column header"),
+      align: str(void 0, {
+        enum: [
+          "left",
+          "right",
+          "center"
+        ]
+      }),
+      format: str("How to format values", {
+        enum: [
+          "text",
+          "number",
+          "currency",
+          "percent",
+          "date",
+          "link"
+        ]
+      })
+    }, [
+      "key",
+      "label"
+    ]), {
+      minItems: 1,
+      maxItems: 12
+    }),
+    rows: arr(row, {
+      maxItems: 500
+    })
+  }, [
+    "columns",
+    "rows"
+  ]),
+  fallbackText: /* @__PURE__ */ __name((props) => `${heading(props)}${textTable(props.columns ?? [], props.rows ?? [])}`, "fallbackText")
+});
+var Chart = defineComponent({
+  name: "Chart",
+  title: "Chart",
+  description: "`bar` to compare categories, `line` for a trend over time. `data` is a list of points; `xKey` names the category/time field and each series names a numeric field.",
+  props: obj({
+    type: str("Chart type", {
+      enum: [
+        "bar",
+        "line"
+      ]
+    }),
+    title: str(),
+    xKey: str("Field of each point used for the x axis"),
+    series: arr(obj({
+      key: str("Numeric field"),
+      label: str()
+    }, [
+      "key"
+    ]), {
+      minItems: 1,
+      maxItems: 6
+    }),
+    data: arr(row, {
+      minItems: 1,
+      maxItems: 200
+    }),
+    unit: str("Unit shown after values, e.g. `KB` or `%`")
+  }, [
+    "type",
+    "xKey",
+    "series",
+    "data"
+  ]),
+  fallbackText: /* @__PURE__ */ __name((props) => {
+    const series = props.series ?? [];
+    const data = props.data ?? [];
+    const first = series[0]?.key ?? "";
+    const max = Math.max(0, ...data.map((point) => Math.abs(Number(point[first]) || 0)));
+    const unit = props.unit ? ` ${s(props.unit)}` : "";
+    const lines = data.slice(0, 20).map((point) => `${s(point[props.xKey]).slice(0, 18).padEnd(18)} ${bar(Number(point[first]) || 0, max)} ${s(point[first])}${unit}`);
+    return `${heading(props)}\`\`\`
+${lines.join("\n")}
+\`\`\``;
+  }, "fallbackText")
+});
+var KpiCards = defineComponent({
+  name: "KpiCards",
+  title: "KPI cards",
+  description: "A few key numbers (metrics, totals, counts) as cards.",
+  props: obj({
+    title: str(),
+    items: arr(obj({
+      label: str(),
+      value: {
+        type: [
+          "string",
+          "number"
+        ]
+      },
+      delta: str("Change, e.g. `+12%`"),
+      trend: str(void 0, {
+        enum: [
+          "up",
+          "down",
+          "flat"
+        ]
+      }),
+      hint: str()
+    }, [
+      "label",
+      "value"
+    ]), {
+      minItems: 1,
+      maxItems: 8
+    })
+  }, [
+    "items"
+  ]),
+  fallbackText: /* @__PURE__ */ __name((props) => `${heading(props)}${(props.items ?? []).map((item) => `\u2022 *${s(item.label)}:* ${s(item.value)}${item.delta ? ` (${s(item.delta)})` : ""}`).join("\n")}`, "fallbackText")
+});
+var SourceCards = defineComponent({
+  name: "SourceCards",
+  title: "Sources",
+  description: "The documents, pages or links an answer is based on, as cards.",
+  props: obj({
+    title: str(),
+    items: arr(obj({
+      title: str(),
+      url: str(),
+      snippet: str(),
+      source: str("e.g. Wiki, GitHub")
+    }, [
+      "title"
+    ]), {
+      minItems: 1,
+      maxItems: 12
+    })
+  }, [
+    "items"
+  ]),
+  fallbackText: /* @__PURE__ */ __name((props) => `${heading(props)}${(props.items ?? []).map((item) => `\u2022 ${item.url ? `<${s(item.url)}|${s(item.title)}>` : s(item.title)}${item.source ? ` \u2014 ${s(item.source)}` : ""}`).join("\n")}`, "fallbackText")
+});
+var Checklist = defineComponent({
+  name: "Checklist",
+  title: "Checklist",
+  description: "Steps or a to-do list with done/not-done state.",
+  props: obj({
+    title: str(),
+    items: arr(obj({
+      label: str(),
+      done: {
+        type: "boolean"
+      },
+      note: str()
+    }, [
+      "label"
+    ]), {
+      minItems: 1,
+      maxItems: 50
+    })
+  }, [
+    "items"
+  ]),
+  fallbackText: /* @__PURE__ */ __name((props) => `${heading(props)}${(props.items ?? []).map((item) => `${item.done ? "\u2611" : "\u2610"} ${s(item.label)}${item.note ? ` \u2014 _${s(item.note)}_` : ""}`).join("\n")}`, "fallbackText")
+});
+var Timeline = defineComponent({
+  name: "Timeline",
+  title: "Timeline",
+  description: "Events in chronological order (the history of a project, an incident, a deal).",
+  props: obj({
+    title: str(),
+    events: arr(obj({
+      date: str(),
+      title: str(),
+      description: str()
+    }, [
+      "title"
+    ]), {
+      minItems: 1,
+      maxItems: 50
+    })
+  }, [
+    "events"
+  ]),
+  fallbackText: /* @__PURE__ */ __name((props) => `${heading(props)}${(props.events ?? []).map((event) => `\u2022 ${event.date ? `*${s(event.date)}* ` : ""}${s(event.title)}${event.description ? ` \u2014 ${s(event.description)}` : ""}`).join("\n")}`, "fallbackText")
+});
+var CodeBlock = defineComponent({
+  name: "CodeBlock",
+  title: "Code",
+  description: "A code snippet or file excerpt with syntax highlighting.",
+  props: obj({
+    title: str(),
+    language: str(),
+    code: str()
+  }, [
+    "code"
+  ]),
+  fallbackText: /* @__PURE__ */ __name((props) => `${heading(props)}\`\`\`
+${s(props.code)}
+\`\`\``, "fallbackText")
+});
+var Diff = defineComponent({
+  name: "Diff",
+  title: "Diff",
+  description: "A before/after change to a text or code file, as a line diff.",
+  props: obj({
+    title: str(),
+    language: str(),
+    before: str(),
+    after: str()
+  }, [
+    "before",
+    "after"
+  ]),
+  fallbackText: /* @__PURE__ */ __name((props) => `${heading(props)}\`\`\`
+${lineDiff(s(props.before), s(props.after)).map((line) => `${line.op === "add" ? "+" : line.op === "del" ? "-" : " "} ${line.text}`).join("\n")}
+\`\`\``, "fallbackText")
+});
+var Callout = defineComponent({
+  name: "Callout",
+  title: "Callout",
+  description: "A short note, warning or success message, emphasized.",
+  props: obj({
+    tone: str(void 0, {
+      enum: [
+        "info",
+        "success",
+        "warning",
+        "danger"
+      ]
+    }),
+    title: str(),
+    text: str()
+  }, [
+    "text"
+  ]),
+  fallbackText: /* @__PURE__ */ __name((props) => `${props.tone === "warning" || props.tone === "danger" ? ":warning: " : ":information_source: "}${heading(props)}${s(props.text)}`, "fallbackText")
+});
+var Stack = defineComponent({
+  name: "Stack",
+  title: "Stack",
+  description: "Lays its children out vertically (or horizontally with direction=row).",
+  props: obj({
+    direction: str(void 0, {
+      enum: [
+        "column",
+        "row"
+      ]
+    }),
+    gap: {
+      type: "number"
+    }
+  }),
+  children: true,
+  fallbackText: /* @__PURE__ */ __name(() => "", "fallbackText")
+});
+var Card = defineComponent({
+  name: "Card",
+  title: "Card",
+  description: "A box with an optional title around its children.",
+  props: obj({
+    title: str(),
+    subtitle: str()
+  }),
+  children: true,
+  fallbackText: /* @__PURE__ */ __name((props) => props.title ? `*${s(props.title)}*${props.subtitle ? ` \u2014 ${s(props.subtitle)}` : ""}` : "", "fallbackText")
+});
+var Heading = defineComponent({
+  name: "Heading",
+  title: "Heading",
+  description: "A heading.",
+  props: obj({
+    text: str()
+  }, [
+    "text"
+  ]),
+  fallbackText: /* @__PURE__ */ __name((props) => `*${s(props.text)}*`, "fallbackText")
+});
+var Text = defineComponent({
+  name: "Text",
+  title: "Text",
+  description: "A paragraph of plain text (no markdown).",
+  props: obj({
+    text: str(),
+    muted: {
+      type: "boolean"
+    }
+  }, [
+    "text"
+  ]),
+  fallbackText: /* @__PURE__ */ __name((props) => s(props.text), "fallbackText")
+});
+var Badge = defineComponent({
+  name: "Badge",
+  title: "Badge",
+  description: "A small label.",
+  props: obj({
+    text: str(),
+    tone: str(void 0, {
+      enum: [
+        "neutral",
+        "brand",
+        "success",
+        "warning",
+        "danger"
+      ]
+    })
+  }, [
+    "text"
+  ]),
+  fallbackText: /* @__PURE__ */ __name((props) => `[${s(props.text)}]`, "fallbackText")
+});
+var Link = defineComponent({
+  name: "Link",
+  title: "Link",
+  description: "A link to an http(s) URL.",
+  props: obj({
+    text: str(),
+    url: str(void 0, {
+      pattern: "^https?://"
+    })
+  }, [
+    "text",
+    "url"
+  ]),
+  fallbackText: /* @__PURE__ */ __name((props) => `<${s(props.url)}|${s(props.text || props.url)}>`, "fallbackText")
+});
+var Image = defineComponent({
+  name: "Image",
+  title: "Image",
+  description: "An image from an https URL.",
+  props: obj({
+    url: str(void 0, {
+      pattern: "^https://"
+    }),
+    alt: str()
+  }, [
+    "url"
+  ]),
+  fallbackText: /* @__PURE__ */ __name((props) => s(props.url), "fallbackText")
+});
+
+// src/genui/registry.ts
+function snapshotComponentPresentation(value) {
+  const seen = /* @__PURE__ */ new Set();
+  const check2 = /* @__PURE__ */ __name((entry) => {
+    if (entry === null || typeof entry === "string" || typeof entry === "boolean") return;
+    if (typeof entry === "number" && Number.isFinite(entry)) return;
+    if (typeof entry !== "object" || entry === null) throw new TypeError("genui: presentation must contain only JSON values");
+    if (seen.has(entry)) throw new TypeError("genui: presentation must contain acyclic JSON values");
+    if (!Array.isArray(entry) && Object.getPrototypeOf(entry) !== Object.prototype && Object.getPrototypeOf(entry) !== null) throw new TypeError("genui: presentation must contain plain JSON objects");
+    seen.add(entry);
+    for (const item of Object.values(entry)) check2(item);
+    seen.delete(entry);
+  }, "check");
+  check2(value);
+  return JSON.parse(JSON.stringify(value));
+}
+__name(snapshotComponentPresentation, "snapshotComponentPresentation");
+function createComponent(definition, options = {}) {
+  defineComponent(definition);
+  const catalog = defineCatalog([
+    definition
+  ], options);
+  const factory = /* @__PURE__ */ __name(async (props) => {
+    const result2 = await validateProps(definition.props, props, catalog.validator);
+    if (!result2.ok) throw new Error(`genui: invalid ${definition.name} props: ${formatIssues(result2.issues)}`);
+    const normalized = snapshotComponentPresentation(result2.value);
+    if (typeof normalized !== "object" || normalized === null || Array.isArray(normalized)) throw new TypeError("genui: component props must be a JSON object");
+    const portable = await catalog.validate(definition.name, normalized);
+    if (!portable.ok || canonicalJson(snapshotComponentPresentation(portable.value)) !== canonicalJson(normalized)) {
+      throw new Error(`genui: ${definition.name} requires outputProps accepting stable normalized JSON props`);
+    }
+    return {
+      component: definition.name,
+      props: normalized,
+      version: definition.version ?? 1,
+      fallbackText: componentToText(catalog, definition.name, normalized)
+    };
+  }, "factory");
+  return Object.assign(factory, {
+    definition
+  });
+}
+__name(createComponent, "createComponent");
+var table = createComponent(DataTable);
+var chart = createComponent(Chart);
+function validatePresentationBatch(presentations) {
+  const batch = Array.isArray(presentations) ? presentations : [
+    presentations
+  ];
+  return batch.map((item) => {
+    const presentation = snapshotComponentPresentation(item);
+    if (typeof presentation !== "object" || presentation === null || typeof presentation.component !== "string" || !/^[A-Za-z][A-Za-z0-9]{0,63}$/.test(presentation.component) || !Number.isSafeInteger(presentation.version) || presentation.version <= 0 || typeof presentation.fallbackText !== "string" || typeof presentation.props !== "object" || presentation.props === null || Array.isArray(presentation.props)) {
+      throw new TypeError("genui: invalid component presentation");
+    }
+    return presentation;
+  });
+}
+__name(validatePresentationBatch, "validatePresentationBatch");
+function canonicalJson(value) {
+  if (Array.isArray(value)) return `[${value.map(canonicalJson).join(",")}]`;
+  if (typeof value === "object" && value !== null) {
+    const record2 = value;
+    return `{${Object.keys(record2).sort().map((key) => `${JSON.stringify(key)}:${canonicalJson(record2[key])}`).join(",")}}`;
+  }
+  return JSON.stringify(value);
+}
+__name(canonicalJson, "canonicalJson");
+
+// src/tool-presentations.ts
+async function emitToolPresentations(handler, output, ctx, toolName) {
+  if (handler.present === void 0) return;
+  try {
+    const result2 = await handler.present(output, ctx);
+    if (result2 === void 0) return;
+    const batch = validatePresentationBatch(result2);
+    for (const presentation of batch) {
+      await ctx.emitUi(presentation.component, presentation.props, {
+        version: presentation.version,
+        fallbackText: presentation.fallbackText
+      });
+    }
+  } catch (error) {
+    if (ctx.onPresentationError !== void 0) {
+      try {
+        await ctx.onPresentationError(error, {
+          toolName
+        });
+        return;
+      } catch (reportError) {
+        console.warn(`Tool "${toolName}" presentation error reporter failed`, reportError);
+      }
+    } else {
+      console.warn(`Tool "${toolName}" presentation failed after successful execution`, error);
+    }
+  }
+}
+__name(emitToolPresentations, "emitToolPresentations");
+
 // src/tool-registry.ts
 var ToolForbiddenError = class extends Error {
   static {
@@ -4085,6 +4647,15 @@ var ToolRegistry = class {
       handler
     });
   }
+  /** Whether a successful preflight shortcut has UI to journal. */
+  hasPresentation(name) {
+    return typeof this.entries.get(name)?.handler.present === "function";
+  }
+  /** Present an already authorized successful domain result without executing its action again. */
+  async presentOutput(name, output, ctx) {
+    const entry = this.entries.get(name);
+    if (entry !== void 0) await emitToolPresentations(entry.handler, output, ctx, name);
+  }
   has(name) {
     return this.entries.has(name);
   }
@@ -4170,8 +4741,9 @@ var ToolRegistry = class {
     }) : void 0;
     if (trusted) assertTrustedInput(name, hookInput, executionInput);
     if (result2?.status === "denied") throw new ToolPreflightDeniedError(name, result2.reason);
-    if (result2?.status === "completed") return result2.output;
-    return entry.handler.execute(executionInput, withEmit);
+    const output = result2?.status === "completed" ? result2.output : await entry.handler.execute(executionInput, withEmit);
+    await emitToolPresentations(entry.handler, output, withEmit, name);
+    return output;
   }
   /** Authorize and validate without executing. The caller journals this result before approval. */
   async prepare(name, input, ctx, policy, options = {}) {
@@ -4237,6 +4809,7 @@ var DefaultRolesPolicy = class {
     this.emptyRoles = options.emptyRoles ?? "allow";
   }
   can(actor, tool) {
+    if (tool.ability !== void 0 && tool.roles === void 0) return false;
     const allowed = tool.roles ?? this.defaultRoles;
     if (allowed.length === 0) return this.emptyRoles === "allow";
     return (actor.roles ?? []).some((role) => allowed.includes(role));
@@ -4386,7 +4959,8 @@ var AGENT_SPAN_EVENTS = [
   "llm.turn",
   "tool.execution",
   "retrieval",
-  "follow-ups"
+  "follow-ups",
+  "structured-output"
 ];
 var AGENT_DIAGNOSTIC_EVENTS = [
   "run.started",
@@ -4424,8 +4998,19 @@ function createNegotiatedUiCollector(toolCallId, scope, resolveCatalog, write) {
     }, "restart"),
     emit: /* @__PURE__ */ __name(async (component, props, options = {}) => {
       if (!resolveCatalog) {
-        if (scope.uiCapabilities !== void 0) throw new Error("UI capabilities require an authorized server catalog");
-        return collector.emit(component, props, options);
+        const declared = scope.uiCapabilities === void 0 || scope.uiCapabilities.components.some((entry) => entry.name === component && entry.version === (options.version ?? 1));
+        if (declared) return collector.emit(component, props, options);
+        const id2 = options.id ?? `${toolCallId}:ui:${next++}`;
+        if (options.fallbackText !== void 0 && options.fallbackText.length > 0) {
+          texts.set(id2, options.fallbackText);
+          await write?.({
+            kind: "text",
+            text: options.fallbackText
+          });
+        }
+        return {
+          id: id2
+        };
       }
       const capturedProps = snapshotActionProposal(props);
       const capturedOptions = {
@@ -5512,6 +6097,10 @@ async function claimToolCall(turn, call) {
       ...spec?.terminal === true ? {
         terminal: true
       } : {},
+      // Journal this extra checkpoint's opt-in; historical claims without it keep their sequence.
+      ...preflight?.status === "completed" && deps.registry.hasPresentation(call.name) ? {
+        presentCompletedPreflight: true
+      } : {},
       ...approval !== void 0 ? {
         approval
       } : {},
@@ -5542,6 +6131,9 @@ async function claimToolCall(turn, call) {
     ...persisted?.terminal === true ? {
       terminal: true
     } : {},
+    ...persisted?.presentCompletedPreflight === true ? {
+      presentCompletedPreflight: true
+    } : {},
     ...toolType === "action" && persisted?.approval !== void 0 ? {
       approval: persisted.approval
     } : {},
@@ -6068,6 +6660,19 @@ async function runClaimedToolCall(turn, claimed) {
   }
   if (claimed.preflight !== void 0 && claimed.preflight.status !== "ready") {
     const result2 = claimed.preflight;
+    if (result2.status === "completed" && claimed.presentCompletedPreflight === true) {
+      const raw = await hooks.step(`present:${call.id}`, async () => {
+        const ui = createNegotiatedUiCollector(call.id, ctx, deps.resolveUiCatalog, (event) => turn.writer.write(encodeStreamEvent(event)));
+        await deps.registry.presentOutput(call.name, result2.output, {
+          ...toolCallContext(ctx, call.id),
+          emitUi: ui.emit
+        });
+        return wrapToolStepOutput(result2.output, ui.components(), ui.text());
+      });
+      const presented = unwrapToolStepOutput(raw);
+      if (presented.ui.length > 0) turn.toolUi.set(call.id, presented.ui);
+      if (presented.text) turn.toolText.set(call.id, presented.text);
+    }
     if (result2.status === "completed" && claimed.terminal === true) turn.halt.terminal = true;
     const outcome = result2.status === "completed" ? {
       status: "executed",
@@ -6959,14 +7564,14 @@ var InMemoryActionProposalStore = class {
   }
   async createActionProposal(input) {
     validateActionProposalCreation(input);
-    const row = this.rows.get(input.id);
-    if (row) {
-      if (!actionProposalScopeMatches(row, input)) return {
+    const row2 = this.rows.get(input.id);
+    if (row2) {
+      if (!actionProposalScopeMatches(row2, input)) return {
         status: "conflict"
       };
       return {
-        status: actionProposalCreationMatches(row, input) ? "unchanged" : "conflict",
-        proposal: snapshotActionProposal(row)
+        status: actionProposalCreationMatches(row2, input) ? "unchanged" : "conflict",
+        proposal: snapshotActionProposal(row2)
       };
     }
     const proposal = initialActionProposal(input, this.clock());
@@ -6977,42 +7582,42 @@ var InMemoryActionProposalStore = class {
     };
   }
   async getActionProposal(scope, id) {
-    const row = this.rows.get(id);
-    return row && actionProposalScopeMatches(row, scope) ? snapshotActionProposal(row) : null;
+    const row2 = this.rows.get(id);
+    return row2 && actionProposalScopeMatches(row2, scope) ? snapshotActionProposal(row2) : null;
   }
   async listActionProposals(scope, query = {}) {
     const limit = validateActionProposalListQuery(query);
     return [
       ...this.rows.values()
-    ].filter((row) => actionProposalScopeMatches(row, scope) && (query.decision === void 0 || row.decision === query.decision) && (query.after === void 0 || row.createdAt > query.after.createdAt || row.createdAt === query.after.createdAt && row.id > query.after.id)).sort((a, b) => a.createdAt - b.createdAt || (a.id < b.id ? -1 : a.id > b.id ? 1 : 0)).slice(0, limit).map(snapshotActionProposal);
+    ].filter((row2) => actionProposalScopeMatches(row2, scope) && (query.decision === void 0 || row2.decision === query.decision) && (query.after === void 0 || row2.createdAt > query.after.createdAt || row2.createdAt === query.after.createdAt && row2.id > query.after.id)).sort((a, b) => a.createdAt - b.createdAt || (a.id < b.id ? -1 : a.id > b.id ? 1 : 0)).slice(0, limit).map(snapshotActionProposal);
   }
   mutate(scope, id, transition) {
-    const row = this.rows.get(id);
-    if (!row || !actionProposalScopeMatches(row, scope)) return {
+    const row2 = this.rows.get(id);
+    if (!row2 || !actionProposalScopeMatches(row2, scope)) return {
       status: "not_found"
     };
-    const result2 = transition(row, this.clock());
+    const result2 = transition(row2, this.clock());
     if (result2.proposal) this.rows.set(id, snapshotActionProposal(result2.proposal));
     return result2;
   }
   async decideActionProposal(scope, id, command) {
-    return this.mutate(scope, id, (row, now) => transitionActionProposalDecision(row, command, now));
+    return this.mutate(scope, id, (row2, now) => transitionActionProposalDecision(row2, command, now));
   }
   async claimActionProposal(scope, id, command) {
-    return this.mutate(scope, id, (row, now) => transitionActionProposalClaim(row, command, now, (0, import_node_crypto2.randomUUID)()));
+    return this.mutate(scope, id, (row2, now) => transitionActionProposalClaim(row2, command, now, (0, import_node_crypto2.randomUUID)()));
   }
   async extendActionProposalLease(scope, id, command) {
-    return this.mutate(scope, id, (row, now) => transitionActionProposalLease(row, command, now));
+    return this.mutate(scope, id, (row2, now) => transitionActionProposalLease(row2, command, now));
   }
   async settleActionProposal(scope, id, command) {
-    return this.mutate(scope, id, (row, now) => transitionActionProposalSettlement(row, command, now));
+    return this.mutate(scope, id, (row2, now) => transitionActionProposalSettlement(row2, command, now));
   }
   async claimNextActionProposal(command) {
     const now = this.clock();
     validateActionProposalWorkerClaim(command, now);
     const candidates = [
       ...this.rows.values()
-    ].filter((row) => row.decision === "approved" && (row.execution?.status === "queued" || row.execution?.status === "executing" && row.execution.lease !== null && now >= row.execution.lease.expiresAt)).sort((a, b) => a.createdAt - b.createdAt || (a.id < b.id ? -1 : a.id > b.id ? 1 : 0)).slice(0, 32);
+    ].filter((row2) => row2.decision === "approved" && (row2.execution?.status === "queued" || row2.execution?.status === "executing" && row2.execution.lease !== null && now >= row2.execution.lease.expiresAt)).sort((a, b) => a.createdAt - b.createdAt || (a.id < b.id ? -1 : a.id > b.id ? 1 : 0)).slice(0, 32);
     for (const candidate of candidates) {
       const claimed = await this.claimActionProposal(candidate, candidate.id, command);
       if (claimed.status === "applied" && claimed.proposal) return claimed.proposal;
@@ -7024,7 +7629,7 @@ var InMemoryActionProposalStore = class {
     validateActionProposalExpiryBatch(command, now);
     const candidates = [
       ...this.rows.values()
-    ].filter((row) => row.decision === "pending" && row.expiresAt !== null && now >= row.expiresAt).sort((a, b) => a.createdAt - b.createdAt || (a.id < b.id ? -1 : a.id > b.id ? 1 : 0)).slice(0, command.limit);
+    ].filter((row2) => row2.decision === "pending" && row2.expiresAt !== null && now >= row2.expiresAt).sort((a, b) => a.createdAt - b.createdAt || (a.id < b.id ? -1 : a.id > b.id ? 1 : 0)).slice(0, command.limit);
     let expired = 0;
     for (const candidate of candidates) {
       const result2 = await this.decideActionProposal(candidate, candidate.id, {
@@ -7041,11 +7646,11 @@ var InMemoryActionProposalStore = class {
     validateActionProposalWorkerClaim(command, now);
     const candidates = [
       ...this.rows.values()
-    ].filter((row) => row.outcomeDelivery?.status === "pending" && (!row.outcomeDelivery.lease || now >= row.outcomeDelivery.lease.expiresAt)).sort((a, b) => a.createdAt - b.createdAt || (a.id < b.id ? -1 : a.id > b.id ? 1 : 0)).slice(0, 32);
+    ].filter((row2) => row2.outcomeDelivery?.status === "pending" && (!row2.outcomeDelivery.lease || now >= row2.outcomeDelivery.lease.expiresAt)).sort((a, b) => a.createdAt - b.createdAt || (a.id < b.id ? -1 : a.id > b.id ? 1 : 0)).slice(0, 32);
     for (const candidate of candidates) {
-      const row = this.rows.get(candidate.id);
-      if (!row) continue;
-      const next = claimActionProposalOutcome(row, command, this.clock(), (0, import_node_crypto2.randomUUID)());
+      const row2 = this.rows.get(candidate.id);
+      if (!row2) continue;
+      const next = claimActionProposalOutcome(row2, command, this.clock(), (0, import_node_crypto2.randomUUID)());
       if (!next?.outcome || !next.outcomeDelivery?.lease) continue;
       this.rows.set(next.id, next);
       return {
@@ -7065,9 +7670,9 @@ var InMemoryActionProposalStore = class {
     if (existing) return this.createActionProposal(input);
     const proposal = initialActionProposal(input, this.clock());
     const replacements = [];
-    if (input.replacementKey) for (const row of this.rows.values()) {
-      if (row.decision !== "pending" || !actionProposalScopeMatches(row, input) || row.toolName !== input.toolName || row.replacementKey !== input.replacementKey) continue;
-      const result2 = transitionActionProposalSupersession(row, proposal, {
+    if (input.replacementKey) for (const row2 of this.rows.values()) {
+      if (row2.decision !== "pending" || !actionProposalScopeMatches(row2, input) || row2.toolName !== input.toolName || row2.replacementKey !== input.replacementKey) continue;
+      const result2 = transitionActionProposalSupersession(row2, proposal, {
         replacementProposalId: proposal.id,
         actorRef: input.actorRef,
         via: "supersession"
@@ -7075,7 +7680,7 @@ var InMemoryActionProposalStore = class {
       if (result2.proposal) replacements.push(result2.proposal);
     }
     this.rows.set(proposal.id, proposal);
-    for (const row of replacements) this.rows.set(row.id, row);
+    for (const row2 of replacements) this.rows.set(row2.id, row2);
     return {
       status: "created",
       proposal: snapshotActionProposal(proposal)
@@ -7086,7 +7691,7 @@ var InMemoryActionProposalStore = class {
     if (!replacement || !actionProposalScopeMatches(replacement, scope)) return {
       status: "not_found"
     };
-    return this.mutate(scope, id, (row, now) => transitionActionProposalSupersession(row, replacement, command, now));
+    return this.mutate(scope, id, (row2, now) => transitionActionProposalSupersession(row2, replacement, command, now));
   }
 };
 
@@ -7111,7 +7716,7 @@ var InMemoryAgentStore = class extends InMemoryActionProposalStore {
       throw new Error(`thread ${id} already exists`);
     }
     const ts = this.now();
-    const row = {
+    const row2 = {
       id,
       actorRef: input.actor.id,
       tenantRef: input.actor.tenantRef ?? null,
@@ -7124,20 +7729,20 @@ var InMemoryAgentStore = class extends InMemoryActionProposalStore {
         persona: input.persona
       } : {}
     };
-    this.threads.set(id, row);
-    return this.toSummary(row);
+    this.threads.set(id, row2);
+    return this.toSummary(row2);
   }
   async getThread(threadId) {
-    const row = this.threads.get(threadId);
-    if (row === void 0) {
+    const row2 = this.threads.get(threadId);
+    if (row2 === void 0) {
       return null;
     }
     return {
-      ...this.toSummary(row),
-      messages: row.messages.map((message) => this.withApprovals(message)),
+      ...this.toSummary(row2),
+      messages: row2.messages.map((message) => this.withApprovals(message)),
       // The run streaming right now — the one field the read-model reports it under.
-      ...row.activeStreamId !== void 0 ? {
-        activeRunId: row.activeStreamId
+      ...row2.activeStreamId !== void 0 ? {
+        activeRunId: row2.activeStreamId
       } : {}
     };
   }
@@ -7203,7 +7808,7 @@ var InMemoryAgentStore = class extends InMemoryActionProposalStore {
   async listThreads(actorRef, limit = 50) {
     return [
       ...this.threads.values()
-    ].filter((row) => row.actorRef === actorRef && !row.transient).sort((a, b) => b.updatedAt.localeCompare(a.updatedAt)).slice(0, limit).map((row) => this.toSummary(row));
+    ].filter((row2) => row2.actorRef === actorRef && !row2.transient).sort((a, b) => b.updatedAt.localeCompare(a.updatedAt)).slice(0, limit).map((row2) => this.toSummary(row2));
   }
   async softDeleteThread(threadId) {
     this.threads.delete(threadId);
@@ -7219,7 +7824,7 @@ var InMemoryAgentStore = class extends InMemoryActionProposalStore {
     ];
     const id = crypto.randomUUID();
     const ts = this.now();
-    const row = {
+    const row2 = {
       id,
       actorRef: source.actorRef,
       tenantRef: source.tenantRef,
@@ -7241,8 +7846,8 @@ var InMemoryAgentStore = class extends InMemoryActionProposalStore {
         persona: source.persona
       } : {}
     };
-    this.threads.set(id, row);
-    return this.toSummary(row);
+    this.threads.set(id, row2);
+    return this.toSummary(row2);
   }
   async ownerOfThread(threadId) {
     return this.threads.get(threadId)?.actorRef ?? null;
@@ -7262,38 +7867,38 @@ var InMemoryAgentStore = class extends InMemoryActionProposalStore {
     return call.runId ?? this.threads.get(call.threadId)?.activeStreamId ?? null;
   }
   async ownerOfActiveStream(runId) {
-    for (const row of this.threads.values()) {
-      if (row.activeStreamId === runId) {
-        return row.actorRef;
+    for (const row2 of this.threads.values()) {
+      if (row2.activeStreamId === runId) {
+        return row2.actorRef;
       }
     }
     return null;
   }
   async setTitle(threadId, title) {
-    const row = this.threads.get(threadId);
-    if (row !== void 0) {
-      row.title = title;
-      row.updatedAt = this.now();
+    const row2 = this.threads.get(threadId);
+    if (row2 !== void 0) {
+      row2.title = title;
+      row2.updatedAt = this.now();
     }
   }
   async updateThread(threadId, patch) {
-    const row = this.threads.get(threadId);
-    if (row === void 0) {
+    const row2 = this.threads.get(threadId);
+    if (row2 === void 0) {
       return;
     }
     if (patch.title !== void 0) {
-      row.title = patch.title;
+      row2.title = patch.title;
     }
     if (patch.defaultAgent !== void 0) {
-      row.defaultAgent = patch.defaultAgent;
+      row2.defaultAgent = patch.defaultAgent;
     }
     if (patch.model !== void 0) {
-      row.model = patch.model;
+      row2.model = patch.model;
     }
     if (patch.persona !== void 0) {
-      row.persona = patch.persona;
+      row2.persona = patch.persona;
     }
-    row.updatedAt = this.now();
+    row2.updatedAt = this.now();
   }
   async activeRunForThread(threadId) {
     return this.threads.get(threadId)?.activeStreamId ?? null;
@@ -7341,64 +7946,64 @@ var InMemoryAgentStore = class extends InMemoryActionProposalStore {
   }
   /** Settle a run's outcome. A no-op when the run is unknown (mirrors `setTitle`/`updateThread`). */
   async recordRunEnd(end) {
-    const row = this.runs.get(end.runId);
-    if (row === void 0) {
+    const row2 = this.runs.get(end.runId);
+    if (row2 === void 0) {
       return;
     }
-    row.status = end.status;
-    row.settledAt = this.now();
+    row2.status = end.status;
+    row2.settledAt = this.now();
     if (end.durationMs !== void 0) {
-      row.durationMs = end.durationMs;
+      row2.durationMs = end.durationMs;
     }
     if (end.errorCode !== void 0) {
-      row.errorCode = end.errorCode;
+      row2.errorCode = end.errorCode;
     }
     if (end.errorMessage !== void 0) {
-      row.errorMessage = end.errorMessage;
+      row2.errorMessage = end.errorMessage;
     }
   }
   /** Bump the run's llm-step retry counter. */
   async bumpRunRetries(runId) {
-    const row = this.runs.get(runId);
-    if (row !== void 0) {
-      row.retries += 1;
+    const row2 = this.runs.get(runId);
+    if (row2 !== void 0) {
+      row2.retries += 1;
     }
   }
   async promoteThread(threadId) {
-    const row = this.threads.get(threadId);
-    if (row?.transient) {
-      row.transient = false;
-      row.updatedAt = this.now();
+    const row2 = this.threads.get(threadId);
+    if (row2?.transient) {
+      row2.transient = false;
+      row2.updatedAt = this.now();
     }
   }
   async setActiveStream(threadId, runId) {
-    const row = this.threads.get(threadId);
-    if (row !== void 0) {
+    const row2 = this.threads.get(threadId);
+    if (row2 !== void 0) {
       if (runId === null) {
-        delete row.activeStreamId;
+        delete row2.activeStreamId;
       } else {
-        row.activeStreamId = runId;
+        row2.activeStreamId = runId;
       }
     }
   }
   async claimActiveStream(threadId, runId, options = {}) {
-    const row = this.threads.get(threadId);
-    if (row === void 0) {
+    const row2 = this.threads.get(threadId);
+    if (row2 === void 0) {
       return false;
     }
-    const holder = row.activeStreamId;
+    const holder = row2.activeStreamId;
     if (holder !== void 0 && holder !== runId && holder !== options.replacing) {
       return false;
     }
-    row.activeStreamId = runId;
+    row2.activeStreamId = runId;
     return true;
   }
   async releaseActiveStream(threadId, runId) {
-    const row = this.threads.get(threadId);
-    if (row?.activeStreamId !== runId) {
+    const row2 = this.threads.get(threadId);
+    if (row2?.activeStreamId !== runId) {
       return false;
     }
-    delete row.activeStreamId;
+    delete row2.activeStreamId;
     return true;
   }
   async enqueueMessage(input) {
@@ -7426,6 +8031,9 @@ var InMemoryAgentStore = class extends InMemoryActionProposalStore {
       ...input.uiCapabilities !== void 0 ? {
         uiCapabilities: input.uiCapabilities
       } : {},
+      ...input.hostContext !== void 0 ? {
+        hostContext: input.hostContext
+      } : {},
       ...input.interrupt === true ? {
         interrupt: true
       } : {},
@@ -7531,38 +8139,38 @@ var InMemoryAgentStore = class extends InMemoryActionProposalStore {
     return void 0;
   }
   async getThreadActionProposalScope(threadId) {
-    const row = this.threads.get(threadId);
-    return row ? {
+    const row2 = this.threads.get(threadId);
+    return row2 ? {
       threadId,
-      actorRef: row.actorRef,
-      tenantRef: row.tenantRef
+      actorRef: row2.actorRef,
+      tenantRef: row2.tenantRef
     } : null;
   }
   async admitActionProposalOutcome(command) {
-    const row = [
+    const row2 = [
       ...this.rows.values()
-    ].find((row2) => row2.outcome?.id === command.outcomeId);
-    if (!row?.outcome || !row.outcomeDelivery) return {
+    ].find((row3) => row3.outcome?.id === command.outcomeId);
+    if (!row2?.outcome || !row2.outcomeDelivery) return {
       status: "not_found"
     };
-    if (row.outcomeDelivery.status === "admitted") return {
+    if (row2.outcomeDelivery.status === "admitted") return {
       status: "unchanged",
-      ...row.outcomeDelivery.messageId !== void 0 ? {
-        messageId: row.outcomeDelivery.messageId
+      ...row2.outcomeDelivery.messageId !== void 0 ? {
+        messageId: row2.outcomeDelivery.messageId
       } : {}
     };
-    if (row.outcomeDelivery.status === "discarded") return {
+    if (row2.outcomeDelivery.status === "discarded") return {
       status: "discarded"
     };
-    if (!actionProposalOutcomeFenceValid(row, command, this.clock())) return {
+    if (!actionProposalOutcomeFenceValid(row2, command, this.clock())) return {
       status: "conflict"
     };
-    const thread = this.threads.get(row.threadId);
+    const thread = this.threads.get(row2.threadId);
     if (!thread) {
-      this.rows.set(row.id, snapshotActionProposal({
-        ...row,
+      this.rows.set(row2.id, snapshotActionProposal({
+        ...row2,
         outcomeDelivery: {
-          ...row.outcomeDelivery,
+          ...row2.outcomeDelivery,
           status: "discarded",
           lease: null
         }
@@ -7571,7 +8179,7 @@ var InMemoryAgentStore = class extends InMemoryActionProposalStore {
         status: "discarded"
       };
     }
-    if (thread.actorRef !== row.actorRef || thread.tenantRef !== row.tenantRef) return {
+    if (thread.actorRef !== row2.actorRef || thread.tenantRef !== row2.tenantRef) return {
       status: "conflict"
     };
     if (thread.activeStreamId) return {
@@ -7580,15 +8188,15 @@ var InMemoryAgentStore = class extends InMemoryActionProposalStore {
     const message = {
       id: crypto.randomUUID(),
       role: "assistant",
-      content: actionProposalOutcomeText(row.outcome),
+      content: actionProposalOutcomeText(row2.outcome),
       createdAt: this.now(),
-      actionProposalOutcome: snapshotActionProposal(row.outcome),
-      ui: snapshotActionProposal(row.outcome.ui)
+      actionProposalOutcome: snapshotActionProposal(row2.outcome),
+      ui: snapshotActionProposal(row2.outcome.ui)
     };
     const next = snapshotActionProposal({
-      ...row,
+      ...row2,
       outcomeDelivery: {
-        ...row.outcomeDelivery,
+        ...row2.outcomeDelivery,
         status: "admitted",
         lease: null,
         messageId: message.id
@@ -7596,15 +8204,15 @@ var InMemoryAgentStore = class extends InMemoryActionProposalStore {
     });
     thread.messages.push(message);
     thread.updatedAt = message.createdAt;
-    this.rows.set(row.id, next);
+    this.rows.set(row2.id, next);
     return {
       status: "applied",
       messageId: message.id
     };
   }
   async appendMessage(input) {
-    const row = this.threads.get(input.threadId);
-    if (row === void 0) {
+    const row2 = this.threads.get(input.threadId);
+    if (row2 === void 0) {
       throw new Error(`thread ${input.threadId} not found`);
     }
     const message = {
@@ -7649,13 +8257,13 @@ var InMemoryAgentStore = class extends InMemoryActionProposalStore {
         actionProposalOutcome: input.actionProposalOutcome
       } : {}
     };
-    row.messages.push(message);
-    row.updatedAt = message.createdAt;
+    row2.messages.push(message);
+    row2.updatedAt = message.createdAt;
     return message;
   }
   async setMessageToolResults(messageId, results) {
-    for (const row of this.threads.values()) {
-      const message = row.messages.find((candidate) => candidate.id === messageId);
+    for (const row2 of this.threads.values()) {
+      const message = row2.messages.find((candidate) => candidate.id === messageId);
       if (message !== void 0) {
         message.toolResults = results;
         return;
@@ -7663,12 +8271,12 @@ var InMemoryAgentStore = class extends InMemoryActionProposalStore {
     }
   }
   async setMessageUi(messageId, ui) {
-    for (const row of this.threads.values()) {
-      const index = row.messages.findIndex((candidate) => candidate.id === messageId);
-      const message = row.messages[index];
+    for (const row2 of this.threads.values()) {
+      const index = row2.messages.findIndex((candidate) => candidate.id === messageId);
+      const message = row2.messages[index];
       if (message !== void 0) {
         const { ui: _previous, ...rest } = message;
-        row.messages[index] = ui.length > 0 ? {
+        row2.messages[index] = ui.length > 0 ? {
           ...rest,
           ui
         } : rest;
@@ -7680,12 +8288,12 @@ var InMemoryAgentStore = class extends InMemoryActionProposalStore {
     return this.threadIdForMessage(messageId) ?? null;
   }
   async setMessageFeedback(messageId, feedback) {
-    for (const row of this.threads.values()) {
-      const index = row.messages.findIndex((candidate) => candidate.id === messageId);
-      const message = row.messages[index];
+    for (const row2 of this.threads.values()) {
+      const index = row2.messages.findIndex((candidate) => candidate.id === messageId);
+      const message = row2.messages[index];
       if (message !== void 0) {
         const { feedback: _previous, ...rest } = message;
-        row.messages[index] = feedback !== null ? {
+        row2.messages[index] = feedback !== null ? {
           ...rest,
           feedback
         } : rest;
@@ -7694,13 +8302,13 @@ var InMemoryAgentStore = class extends InMemoryActionProposalStore {
     }
   }
   async truncateFrom(threadId, messageId) {
-    const row = this.threads.get(threadId);
-    if (row === void 0) {
+    const row2 = this.threads.get(threadId);
+    if (row2 === void 0) {
       return;
     }
-    const cutoff = row.messages.findIndex((message) => message.id === messageId);
+    const cutoff = row2.messages.findIndex((message) => message.id === messageId);
     if (cutoff >= 0) {
-      row.messages = row.messages.slice(0, cutoff);
+      row2.messages = row2.messages.slice(0, cutoff);
     }
   }
   /**
@@ -7765,16 +8373,16 @@ var InMemoryAgentStore = class extends InMemoryActionProposalStore {
   async toolCallOutcomes(toolCallIds) {
     const outcomes = [];
     for (const id of toolCallIds) {
-      const row = this.toolCalls.get(id);
-      if (row !== void 0) {
+      const row2 = this.toolCalls.get(id);
+      if (row2 !== void 0) {
         outcomes.push({
           id,
-          status: row.status,
-          ...row.output !== void 0 ? {
-            output: row.output
+          status: row2.status,
+          ...row2.output !== void 0 ? {
+            output: row2.output
           } : {},
-          ...row.error !== void 0 ? {
-            error: row.error
+          ...row2.error !== void 0 ? {
+            error: row2.error
           } : {}
         });
       }
@@ -7783,38 +8391,38 @@ var InMemoryAgentStore = class extends InMemoryActionProposalStore {
   }
   async failUnsettledToolCalls(runId, error) {
     let settled = 0;
-    for (const row of this.toolCalls.values()) {
-      if (row.runId === runId && row.status === "pending_approval") {
-        row.status = "failed";
-        row.error = error;
+    for (const row2 of this.toolCalls.values()) {
+      if (row2.runId === runId && row2.status === "pending_approval") {
+        row2.status = "failed";
+        row2.error = error;
         settled += 1;
       }
     }
     return settled;
   }
   async updateToolCall(input) {
-    const row = this.toolCalls.get(input.toolCallId);
-    if (row === void 0) {
+    const row2 = this.toolCalls.get(input.toolCallId);
+    if (row2 === void 0) {
       return;
     }
-    row.status = input.status;
+    row2.status = input.status;
     if (input.output !== void 0) {
-      row.output = input.output;
+      row2.output = input.output;
     }
     if (input.error !== void 0) {
-      row.error = input.error;
+      row2.error = input.error;
     }
     if (input.executionMs !== void 0) {
-      row.executionMs = input.executionMs;
+      row2.executionMs = input.executionMs;
     }
     if (input.executedByRef !== void 0) {
-      row.executedByRef = input.executedByRef;
+      row2.executedByRef = input.executedByRef;
     }
     if (input.remember !== void 0) {
-      row.remember = input.remember;
+      row2.remember = input.remember;
     }
     if (input.decidedVia !== void 0) {
-      row.decidedVia = input.decidedVia;
+      row2.decidedVia = input.decidedVia;
     }
   }
   async recordUsage(input) {
@@ -7842,9 +8450,9 @@ var InMemoryAgentStore = class extends InMemoryActionProposalStore {
     return this.usageBetween(actorRef, day, day);
   }
   async usageBetween(actorRef, fromDay, toDay) {
-    const rows = this.usage.filter((row) => row.actorRef === actorRef && row.day >= fromDay && row.day <= toDay);
-    const usedTokens = rows.reduce((sum, row) => sum + row.inputTokens + row.outputTokens, 0);
-    const costUsd = rows.reduce((sum, row) => sum + (row.costUsd ?? 0), 0);
+    const rows = this.usage.filter((row2) => row2.actorRef === actorRef && row2.day >= fromDay && row2.day <= toDay);
+    const usedTokens = rows.reduce((sum, row2) => sum + row2.inputTokens + row2.outputTokens, 0);
+    const costUsd = rows.reduce((sum, row2) => sum + (row2.costUsd ?? 0), 0);
     return {
       usedTokens,
       costUsd
@@ -7852,30 +8460,30 @@ var InMemoryAgentStore = class extends InMemoryActionProposalStore {
   }
   /** Test helper: read the recorded usage rows (modelId + token totals). */
   usageRows() {
-    return this.usage.map((row) => ({
-      actorRef: row.actorRef,
-      tokens: row.inputTokens + row.outputTokens,
-      modelId: row.modelId
+    return this.usage.map((row2) => ({
+      actorRef: row2.actorRef,
+      tokens: row2.inputTokens + row2.outputTokens,
+      modelId: row2.modelId
     }));
   }
   /** Governance read-model feed: recorded usage rows with the input/output split + thread/day. */
   governanceUsage() {
-    return this.usage.map((row) => ({
-      actorRef: row.actorRef,
-      threadId: row.threadId,
-      modelId: row.modelId,
-      inputTokens: row.inputTokens,
-      outputTokens: row.outputTokens,
-      day: row.day,
-      createdAt: row.createdAt,
-      ...row.cacheWriteTokens !== void 0 ? {
-        cacheWriteTokens: row.cacheWriteTokens
+    return this.usage.map((row2) => ({
+      actorRef: row2.actorRef,
+      threadId: row2.threadId,
+      modelId: row2.modelId,
+      inputTokens: row2.inputTokens,
+      outputTokens: row2.outputTokens,
+      day: row2.day,
+      createdAt: row2.createdAt,
+      ...row2.cacheWriteTokens !== void 0 ? {
+        cacheWriteTokens: row2.cacheWriteTokens
       } : {},
-      ...row.cacheReadTokens !== void 0 ? {
-        cacheReadTokens: row.cacheReadTokens
+      ...row2.cacheReadTokens !== void 0 ? {
+        cacheReadTokens: row2.cacheReadTokens
       } : {},
-      ...row.costUsd !== void 0 ? {
-        costUsd: row.costUsd
+      ...row2.costUsd !== void 0 ? {
+        costUsd: row2.costUsd
       } : {}
     }));
   }
@@ -7883,22 +8491,22 @@ var InMemoryAgentStore = class extends InMemoryActionProposalStore {
   governanceToolCalls() {
     return [
       ...this.toolCalls.values()
-    ].map((row) => ({
-      toolCallId: row.toolCallId,
-      toolName: row.toolName,
-      toolType: row.toolType,
-      status: row.status,
-      threadId: row.threadId,
-      messageId: row.messageId,
-      createdAt: row.createdAt,
-      ...row.executionMs !== void 0 ? {
-        executionMs: row.executionMs
+    ].map((row2) => ({
+      toolCallId: row2.toolCallId,
+      toolName: row2.toolName,
+      toolType: row2.toolType,
+      status: row2.status,
+      threadId: row2.threadId,
+      messageId: row2.messageId,
+      createdAt: row2.createdAt,
+      ...row2.executionMs !== void 0 ? {
+        executionMs: row2.executionMs
       } : {},
-      ...row.error !== void 0 ? {
-        error: row.error
+      ...row2.error !== void 0 ? {
+        error: row2.error
       } : {},
-      ...row.runId !== void 0 ? {
-        runId: row.runId
+      ...row2.runId !== void 0 ? {
+        runId: row2.runId
       } : {}
     }));
   }
@@ -7958,51 +8566,51 @@ var InMemoryAgentStore = class extends InMemoryActionProposalStore {
   governanceThreads() {
     return [
       ...this.threads.values()
-    ].map((row) => ({
-      threadId: row.id,
-      title: row.title,
-      actorRef: row.actorRef,
-      messageCount: row.messages.length,
-      updatedAt: row.updatedAt
+    ].map((row2) => ({
+      threadId: row2.id,
+      title: row2.title,
+      actorRef: row2.actorRef,
+      messageCount: row2.messages.length,
+      updatedAt: row2.updatedAt
     }));
   }
   /** Governance read-model feed: recorded run outcomes (the reliability surfaces). */
   governanceRuns() {
     return [
       ...this.runs.values()
-    ].map((row) => ({
-      runId: row.runId,
-      threadId: row.threadId,
-      actorRef: row.actorRef,
-      status: row.status,
-      retries: row.retries,
-      startedAt: row.startedAt,
-      ...row.agentName !== void 0 ? {
-        agentName: row.agentName
+    ].map((row2) => ({
+      runId: row2.runId,
+      threadId: row2.threadId,
+      actorRef: row2.actorRef,
+      status: row2.status,
+      retries: row2.retries,
+      startedAt: row2.startedAt,
+      ...row2.agentName !== void 0 ? {
+        agentName: row2.agentName
       } : {},
-      ...row.parentRunId !== void 0 ? {
-        parentRunId: row.parentRunId
+      ...row2.parentRunId !== void 0 ? {
+        parentRunId: row2.parentRunId
       } : {},
-      ...row.durationMs !== void 0 ? {
-        durationMs: row.durationMs
+      ...row2.durationMs !== void 0 ? {
+        durationMs: row2.durationMs
       } : {},
-      ...row.errorCode !== void 0 ? {
-        errorCode: row.errorCode
+      ...row2.errorCode !== void 0 ? {
+        errorCode: row2.errorCode
       } : {},
-      ...row.errorMessage !== void 0 ? {
-        errorMessage: row.errorMessage
+      ...row2.errorMessage !== void 0 ? {
+        errorMessage: row2.errorMessage
       } : {},
-      ...row.settledAt !== void 0 ? {
-        settledAt: row.settledAt
+      ...row2.settledAt !== void 0 ? {
+        settledAt: row2.settledAt
       } : {},
-      ...row.promptHash !== void 0 ? {
-        promptHash: row.promptHash
+      ...row2.promptHash !== void 0 ? {
+        promptHash: row2.promptHash
       } : {}
     }));
   }
   threadIdForMessage(messageId) {
-    for (const [threadId, row] of this.threads) {
-      if (row.messages.some((message) => message.id === messageId)) {
+    for (const [threadId, row2] of this.threads) {
+      if (row2.messages.some((message) => message.id === messageId)) {
         return threadId;
       }
     }
@@ -8012,54 +8620,54 @@ var InMemoryAgentStore = class extends InMemoryActionProposalStore {
   toolCallRows() {
     return [
       ...this.toolCalls.values()
-    ].map((row) => ({
-      toolCallId: row.toolCallId,
-      toolName: row.toolName,
-      toolType: row.toolType,
-      status: row.status,
-      input: row.input,
-      ...row.output !== void 0 ? {
-        output: row.output
+    ].map((row2) => ({
+      toolCallId: row2.toolCallId,
+      toolName: row2.toolName,
+      toolType: row2.toolType,
+      status: row2.status,
+      input: row2.input,
+      ...row2.output !== void 0 ? {
+        output: row2.output
       } : {},
-      ...row.error !== void 0 ? {
-        error: row.error
+      ...row2.error !== void 0 ? {
+        error: row2.error
       } : {},
-      ...row.runId !== void 0 ? {
-        runId: row.runId
+      ...row2.runId !== void 0 ? {
+        runId: row2.runId
       } : {},
-      ...row.executedByRef !== void 0 ? {
-        executedByRef: row.executedByRef
+      ...row2.executedByRef !== void 0 ? {
+        executedByRef: row2.executedByRef
       } : {},
-      ...row.approver !== void 0 ? {
-        approver: row.approver
+      ...row2.approver !== void 0 ? {
+        approver: row2.approver
       } : {},
-      ...row.expiresAt !== void 0 ? {
-        expiresAt: row.expiresAt
+      ...row2.expiresAt !== void 0 ? {
+        expiresAt: row2.expiresAt
       } : {},
-      ...row.remember !== void 0 ? {
-        remember: row.remember
+      ...row2.remember !== void 0 ? {
+        remember: row2.remember
       } : {},
-      ...row.decidedVia !== void 0 ? {
-        decidedVia: row.decidedVia
+      ...row2.decidedVia !== void 0 ? {
+        decidedVia: row2.decidedVia
       } : {}
     }));
   }
-  toSummary(row) {
-    const last = row.messages[row.messages.length - 1];
+  toSummary(row2) {
+    const last = row2.messages[row2.messages.length - 1];
     return {
-      id: row.id,
-      title: row.title,
-      transient: row.transient,
-      createdAt: row.createdAt,
-      updatedAt: row.updatedAt,
+      id: row2.id,
+      title: row2.title,
+      transient: row2.transient,
+      createdAt: row2.createdAt,
+      updatedAt: row2.updatedAt,
       ...last !== void 0 ? {
         lastMessagePreview: last.content.slice(0, 120)
       } : {},
-      defaultAgent: row.defaultAgent ?? null,
-      ...row.model != null ? {
-        model: row.model
+      defaultAgent: row2.defaultAgent ?? null,
+      ...row2.model != null ? {
+        model: row2.model
       } : {},
-      persona: row.persona ?? null
+      persona: row2.persona ?? null
     };
   }
 };
@@ -8067,22 +8675,22 @@ var InMemoryAgentStore = class extends InMemoryActionProposalStore {
 // src/confirm-token.ts
 var import_node_crypto3 = require("crypto");
 var DEFAULT_CONFIRM_TTL_MS = 15 * 60 * 1e3;
-function canonicalJson(value) {
+function canonicalJson2(value) {
   if (value === void 0) return "null";
   if (value === null || typeof value !== "object") return JSON.stringify(value) ?? "null";
-  if (Array.isArray(value)) return `[${value.map(canonicalJson).join(",")}]`;
+  if (Array.isArray(value)) return `[${value.map(canonicalJson2).join(",")}]`;
   if (typeof value.toJSON === "function") {
-    return canonicalJson(value.toJSON());
+    return canonicalJson2(value.toJSON());
   }
   const entries = Object.entries(value).filter(([, entry]) => entry !== void 0).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
-  return `{${entries.map(([key, entry]) => `${JSON.stringify(key)}:${canonicalJson(entry)}`).join(",")}}`;
+  return `{${entries.map(([key, entry]) => `${JSON.stringify(key)}:${canonicalJson2(entry)}`).join(",")}}`;
 }
-__name(canonicalJson, "canonicalJson");
+__name(canonicalJson2, "canonicalJson");
 function signature(subject, expiresAt, secret) {
   if (secret === "") {
     throw new Error("confirm token: the secret is empty");
   }
-  return (0, import_node_crypto3.createHmac)("sha256", secret).update(canonicalJson([
+  return (0, import_node_crypto3.createHmac)("sha256", secret).update(canonicalJson2([
     "agent-confirm",
     subject.tool,
     subject.actorId,
@@ -8410,8 +9018,8 @@ var SqlTokenStreamSink = class {
   autoPurge;
   writes = /* @__PURE__ */ new Map();
   lastAutoPurge = 0;
-  constructor(table, options = {}) {
-    this.table = table;
+  constructor(table2, options = {}) {
+    this.table = table2;
     this.pollIntervalMs = Math.max(1, options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS);
     this.idlePollIntervalMs = Math.max(this.pollIntervalMs, options.idlePollIntervalMs ?? DEFAULT_IDLE_POLL_INTERVAL_MS);
     this.flushMs = Math.max(0, options.flushMs ?? DEFAULT_FLUSH_MS);
@@ -8553,15 +9161,15 @@ var SqlTokenStreamSink = class {
     let quietSince = Date.now();
     while (true) {
       const rows = await this.table.read(runId, cursor, READ_PAGE);
-      for (const row of rows) {
-        cursor = row.seq;
-        if (row.frame === null) {
-          if (row.error !== null) {
-            throw new AgentStreamError(JSON.parse(row.error));
+      for (const row2 of rows) {
+        cursor = row2.seq;
+        if (row2.frame === null) {
+          if (row2.error !== null) {
+            throw new AgentStreamError(JSON.parse(row2.error));
           }
           return;
         }
-        yield encoder2.encode(row.frame);
+        yield encoder2.encode(row2.frame);
       }
       if (rows.length > 0) {
         quietSince = Date.now();
@@ -8613,8 +9221,8 @@ var SqlTokenStreamSink = class {
 };
 
 // src/action-proposal-text.ts
-function resolveTextActionProposalDecision(text, proposals) {
-  const command = parseTextActionProposalCommand(text);
+function resolveTextActionProposalDecision(text, proposals, vocabulary) {
+  const command = parseTextActionProposalCommand(text, vocabulary);
   if (command.status === "unmatched") return command;
   const { decision, remember } = command;
   const pending = proposals.filter((proposal) => proposal.decision === "pending");
@@ -8649,40 +9257,136 @@ function resolveTextActionProposalDecision(text, proposals) {
   };
 }
 __name(resolveTextActionProposalDecision, "resolveTextActionProposalDecision");
-function parseTextActionProposalCommand(text) {
+var DEFAULT_TEXT_ACTION_PROPOSAL_VOCABULARY = {
+  approve: [
+    "yes",
+    "confirm",
+    "approve",
+    "approved",
+    "ok"
+  ],
+  reject: [
+    "no",
+    "cancel",
+    "reject",
+    "deny"
+  ],
+  remember: [
+    "always in this conversation"
+  ]
+};
+var DEFAULT_TEXT_ACTION_PROPOSAL_REPLIES = {
+  approved: "Proposal approved and queued to run.",
+  rejected: "Proposal rejected; nothing was run.",
+  expired: "The proposal expired; nothing was run.",
+  unchanged: "This proposal could not be changed; refresh the list to see where it stands.",
+  ambiguous: /* @__PURE__ */ __name((ids) => `Which proposal? Reply confirm #ID or cancel #ID: ${ids.join(", ")}`, "ambiguous"),
+  tooMany: "There are several proposals. Confirm or reject one with an explicit #ID."
+};
+function textActionProposalReply(result2, decision, replies = DEFAULT_TEXT_ACTION_PROPOSAL_REPLIES) {
+  return result2.status === "expired" || result2.proposal?.decision === "expired" ? replies.expired : result2.status === "applied" || result2.status === "unchanged" ? decision === "approved" ? replies.approved : replies.rejected : replies.unchanged;
+}
+__name(textActionProposalReply, "textActionProposalReply");
+var escapeRegExp = /* @__PURE__ */ __name((word) => word.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), "escapeRegExp");
+var alternatives = /* @__PURE__ */ __name((words) => words.map((word) => word.trim()).filter((word) => word.length > 0).map((word) => escapeRegExp(word).replace(/\s+/g, "\\s+")).join("|"), "alternatives");
+var fold = /* @__PURE__ */ __name((word) => word.trim().toLowerCase(), "fold");
+function parseTextActionProposalCommand(text, vocabulary = DEFAULT_TEXT_ACTION_PROPOSAL_VOCABULARY) {
   if (/[\r\n]/u.test(text)) return {
     status: "unmatched"
   };
-  const normalized = text.trim();
-  const match = /^(sim|confirmo|confirmar|aprovar|aprovo|cancelar|rejeitar|rejeito|não|nao)(?: (sempre nesta conversa))?(?: #([^\s]+?))?[.!]?$/iu.exec(normalized);
+  const verbs = alternatives([
+    ...vocabulary.approve,
+    ...vocabulary.reject
+  ]);
+  if (verbs.length === 0) return {
+    status: "unmatched"
+  };
+  const remember = alternatives(vocabulary.remember);
+  const match = new RegExp(`^(${verbs})${remember.length > 0 ? `(?: (${remember}))?` : "()"}(?: #([^\\s]+?))?[.!]?$`, "iu").exec(text.trim());
   if (!match) return {
     status: "unmatched"
   };
-  const verb = match[1]?.toLocaleLowerCase("pt-BR");
+  const verb = match[1] === void 0 ? void 0 : fold(match[1]);
   if (verb === void 0) return {
     status: "unmatched"
   };
-  const decision = [
-    "cancelar",
-    "rejeitar",
-    "rejeito",
-    "n\xE3o",
-    "nao"
-  ].includes(verb) ? "rejected" : "approved";
-  const remember = match[2] !== void 0;
-  if (remember && decision !== "approved") return {
+  const decision = vocabulary.reject.some((word) => fold(word) === verb) ? "rejected" : "approved";
+  const remembers = match[2] !== void 0 && match[2] !== "";
+  if (remembers && decision !== "approved") return {
     status: "unmatched"
   };
   return {
     status: "command",
     decision,
-    remember,
+    remember: remembers,
     ...match[3] !== void 0 ? {
       proposalId: match[3]
     } : {}
   };
 }
 __name(parseTextActionProposalCommand, "parseTextActionProposalCommand");
+var ptBrActionProposalText = {
+  vocabulary: {
+    approve: [
+      "sim",
+      "confirmo",
+      "confirmar",
+      "aprovar",
+      "aprovo",
+      "pode",
+      ...DEFAULT_TEXT_ACTION_PROPOSAL_VOCABULARY.approve
+    ],
+    reject: [
+      "n\xE3o",
+      "nao",
+      "cancelar",
+      "cancela",
+      "rejeitar",
+      "rejeito",
+      ...DEFAULT_TEXT_ACTION_PROPOSAL_VOCABULARY.reject
+    ],
+    remember: [
+      "sempre nesta conversa",
+      ...DEFAULT_TEXT_ACTION_PROPOSAL_VOCABULARY.remember
+    ]
+  },
+  replies: {
+    approved: "Proposta aprovada e enfileirada para execu\xE7\xE3o.",
+    rejected: "Proposta rejeitada; nenhuma a\xE7\xE3o foi executada.",
+    expired: "A proposta expirou; nenhuma a\xE7\xE3o foi executada.",
+    unchanged: "N\xE3o foi poss\xEDvel alterar esta proposta; atualize a lista para consultar seu estado.",
+    ambiguous: /* @__PURE__ */ __name((ids) => `Qual proposta? Responda confirmar #ID ou cancelar #ID: ${ids.join(", ")}`, "ambiguous"),
+    tooMany: "H\xE1 v\xE1rias propostas. Confirme ou rejeite usando #ID expl\xEDcito."
+  }
+};
+
+// src/action-proposal-view.ts
+function toActionProposalView(proposal) {
+  const { execution, outcomeDelivery, idempotencyKey: _idempotencyKey, preparationInput: _preparationInput, executionContext: _executionContext, ...rest } = proposal;
+  return {
+    ...rest,
+    execution: execution === null ? null : withoutLease(execution),
+    ...outcomeDelivery !== void 0 ? {
+      outcomeDelivery: withoutLease(outcomeDelivery)
+    } : {}
+  };
+}
+__name(toActionProposalView, "toActionProposalView");
+function toActionProposalMutationView(result2) {
+  const { proposal, ...rest } = result2;
+  return {
+    ...rest,
+    ...proposal !== void 0 ? {
+      proposal: toActionProposalView(proposal)
+    } : {}
+  };
+}
+__name(toActionProposalMutationView, "toActionProposalMutationView");
+function withoutLease(value) {
+  const { lease: _lease, ...rest } = value;
+  return rest;
+}
+__name(withoutLease, "withoutLease");
 
 // src/action-proposal-executor.ts
 var ActionProposalExecutor = class {
@@ -8914,6 +9618,37 @@ function assertIndependentActionCapabilities(store, resolver) {
   if (required.some((method) => typeof candidate[method] !== "function")) throw new Error("Independent action mode requires proposal, worker, outcome and admission capabilities on the conversation store");
 }
 __name(assertIndependentActionCapabilities, "assertIndependentActionCapabilities");
+
+// src/functional-tool.ts
+function createFunctionalTool(definition) {
+  const { input, execute, present, preflight, isEnabled, canUse, describe, kind, ...metadata } = definition;
+  return {
+    spec: {
+      ...metadata,
+      kind: kind ?? "read",
+      inputSchema: input
+    },
+    handler: {
+      execute: execute.bind(definition),
+      ...present === void 0 ? {} : {
+        present: present.bind(definition)
+      },
+      ...preflight === void 0 ? {} : {
+        preflight: preflight.bind(definition)
+      },
+      ...isEnabled === void 0 ? {} : {
+        isEnabled: isEnabled.bind(definition)
+      },
+      ...canUse === void 0 ? {} : {
+        canUse: canUse.bind(definition)
+      },
+      ...describe === void 0 ? {} : {
+        describe: describe.bind(definition)
+      }
+    }
+  };
+}
+__name(createFunctionalTool, "createFunctionalTool");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AGENT_ACTOR_DIRECTORY,
@@ -8964,6 +9699,8 @@ __name(assertIndependentActionCapabilities, "assertIndependentActionCapabilities
   DEFAULT_MAX_SKILLS,
   DEFAULT_REFUSAL_REASON,
   DEFAULT_STRUCTURED_OUTPUT_INSTRUCTION,
+  DEFAULT_TEXT_ACTION_PROPOSAL_REPLIES,
+  DEFAULT_TEXT_ACTION_PROPOSAL_VOCABULARY,
   DEFAULT_TOOL_TRANSIENT_RETRY_ATTEMPTS,
   DEFAULT_TOOL_TRANSIENT_RETRY_BACKOFF_MS,
   DefaultApprovalPolicy,
@@ -9027,6 +9764,7 @@ __name(assertIndependentActionCapabilities, "assertIndependentActionCapabilities
   compositeSkillProvider,
   confirmTokenExpiry,
   createFrameBuffer,
+  createFunctionalTool,
   createIncrementalGate,
   createNegotiatedUiCollector,
   createNoopEmitUi,
@@ -9040,6 +9778,7 @@ __name(assertIndependentActionCapabilities, "assertIndependentActionCapabilities
   detachedDelivered,
   detachedStarted,
   detachedUnsettled,
+  emitToolPresentations,
   encodeStreamEvent,
   escapeUnsafeToolUiText,
   estimateCost,
@@ -9078,6 +9817,7 @@ __name(assertIndependentActionCapabilities, "assertIndependentActionCapabilities
   parseTextActionProposalCommand,
   personaCatalogEntry,
   prepareActionProposal,
+  ptBrActionProposalText,
   publishAgentDelegated,
   publishAgentMemoryResolved,
   publishAgentMemoryWritten,
@@ -9134,6 +9874,9 @@ __name(assertIndependentActionCapabilities, "assertIndependentActionCapabilities
   streamFailure,
   summarizeWithModel,
   tenantScope,
+  textActionProposalReply,
+  toActionProposalMutationView,
+  toActionProposalView,
   toolCallApprovalFromRow,
   toolCallContext,
   traceLlmTurn,