taias 0.1.0 → 0.2.1

package/README.md

@@ -128,59 +128,10 @@ const affordances = await taias.resolve({ toolName: "scan_repo" });
 - `ctx.toolName` - The name of the tool being called
 
 **Returns:** `Affordances | null`
-- Returns `{ advice: string }` with auto-generated advice if a matching step is found
+- Returns an `Affordances` object with `advice` (and more) if a matching step is found
 - Returns `null` if no step matches or handler returns null
 
-## Types
-
-<details>
-<summary>View all types</summary>
-
-```ts
-type TaiasContext = {
-  toolName: string;
-};
-
-type StepDecision = {
-  nextTool: string;
-};
-
-type Affordances = {
-  advice: string;
-};
-
-type StepHandler = (
-  ctx: TaiasContext
-) => StepDecision | null | Promise<StepDecision | null>;
-
-type FlowStep = {
-  toolName: string;
-  handler: StepHandler;
-};
-
-type FlowDefinition = {
-  id: string;
-  steps: Array<FlowStep>;
-};
-
-interface FlowBuilder {
-  step(toolName: string, handler: StepHandler): void;
-}
-
-type TaiasOptions = {
-  flow: FlowDefinition;
-  devMode?: boolean;
-  onMissingStep?: (ctx: TaiasContext) => void;
-};
-
-interface Taias {
-  resolve(ctx: TaiasContext): Affordances | null | Promise<Affordances | null>;
-}
-```
-
-</details>
-
-See the [full documentation](https://taias.xyz/docs) for more details.
+See the [full documentation](https://taias.xyz/docs) for complete API reference and types.
 
 ## Dev Mode
 
@@ -191,7 +142,7 @@ When `devMode: true`, Taias performs additional validation:
 
 1. **Duplicate toolName detection** — Throws an error if a flow defines the same tool name twice:
    ```
-   Taias: Duplicate step for tool 'scan_repo' in flow 'onboard_repo'. V1 supports one handler per tool.
+   Taias: Duplicate step for tool 'scan_repo' in flow 'onboard_repo'. Only one handler per tool is supported.
    ```
 
 2. **Empty nextTool warning** — Logs a warning if a handler returns empty nextTool:

package/dist/index.cjs

@@ -21,7 +21,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   createTaias: () => createTaias,
-  defineFlow: () => defineFlow
+  defineAffordances: () => defineAffordances,
+  defineFlow: () => defineFlow,
+  mergeAffordances: () => mergeAffordances
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -40,51 +42,160 @@ function defineFlow(flowId, builder) {
   };
 }
 
+// src/uiAffordances/types.ts
+function normalizeBinding(input) {
+  if ("toolName" in input) return { key: "nextTool", value: input.toolName };
+  return { key: input.key, value: input.value };
+}
+function makeBindingKey(slot, binding) {
+  return `${slot}::${binding.key}::${binding.value}`;
+}
+
+// src/uiAffordances/indexing.ts
+function buildRegistryIndex(registry) {
+  const byBindingKey = /* @__PURE__ */ new Map();
+  if (!registry) return { byBindingKey };
+  for (const h of registry.handles) {
+    byBindingKey.set(makeBindingKey(h.slot, h.bindsTo), h);
+  }
+  return { byBindingKey };
+}
+
+// src/uiAffordances/select.ts
+var DEFAULT_SLOT_MATCH = {
+  primaryCta: "nextTool",
+  secondaryCta: "nextTool",
+  widgetVariant: "nextTool"
+};
+function selectUiAffordances(decision, index, opts = {}) {
+  const slotMatch = { ...DEFAULT_SLOT_MATCH, ...opts.slotMatch ?? {} };
+  const devMode = !!opts.devMode;
+  const warn = opts.onWarn ?? (() => {
+  });
+  const selections = {};
+  const slots = Object.keys(DEFAULT_SLOT_MATCH);
+  for (const slot of slots) {
+    const field = slotMatch[slot];
+    const value = decision[field];
+    if (!value) continue;
+    const k = makeBindingKey(slot, { key: field, value });
+    const handle = index.byBindingKey.get(k);
+    if (!handle) {
+      if (devMode) warn(`[Taias] No affordance for slot "${slot}" when ${field}="${value}"`);
+      continue;
+    }
+    selections[slot] = { handleId: handle.handleId, bindsTo: handle.bindsTo };
+  }
+  return selections;
+}
+
 // src/createTaias.ts
 function generateAdvice(nextTool) {
   return `FOR THE BEST USER EXPERIENCE, TELL THE USER TO USE THE ${nextTool} TOOL NEXT!!!!!`;
 }
 function createTaias(options) {
-  const { flow, devMode = false, onMissingStep } = options;
+  const {
+    flow,
+    affordances,
+    slotMatch,
+    devMode = false,
+    onMissingStep,
+    onWarn
+  } = options;
+  const warn = onWarn ?? ((msg) => console.warn(msg));
   if (devMode) {
     const seenTools = /* @__PURE__ */ new Set();
     for (const step of flow.steps) {
       if (seenTools.has(step.toolName)) {
         throw new Error(
-          `Taias: Duplicate step for tool '${step.toolName}' in flow '${flow.id}'. V1 supports one handler per tool.`
+          `Taias: Duplicate step for tool '${step.toolName}' in flow '${flow.id}'. Only one handler per tool is supported.`
         );
       }
       seenTools.add(step.toolName);
     }
   }
-  const stepMap = new Map(
-    flow.steps.map((step) => [step.toolName, step.handler])
-  );
+  const stepMap = new Map(flow.steps.map((step) => [step.toolName, step.handler]));
+  const registryIndex = buildRegistryIndex(affordances);
   return {
     async resolve(ctx) {
       const handler = stepMap.get(ctx.toolName);
       if (!handler) {
-        if (onMissingStep) {
-          onMissingStep(ctx);
-        }
+        onMissingStep?.(ctx);
         return null;
       }
       const result = await handler(ctx);
-      if (!result) {
-        return null;
-      }
+      if (!result) return null;
       if (devMode && result.nextTool === "") {
-        console.warn(`Taias: nextTool for tool '${ctx.toolName}' is empty.`);
+        warn(`Taias: nextTool for tool '${ctx.toolName}' is empty.`);
       }
+      const decision = {
+        nextTool: result.nextTool
+      };
+      const selections = selectUiAffordances(decision, registryIndex, {
+        devMode,
+        onWarn: warn,
+        slotMatch
+      });
       return {
-        advice: generateAdvice(result.nextTool)
+        advice: generateAdvice(result.nextTool),
+        decision,
+        selections
       };
     }
   };
 }
+
+// src/uiAffordances/defineAffordances.ts
+function defineAffordances(builder) {
+  const handles = [];
+  const push = (slot, handleId, bindsTo) => {
+    handles.push({
+      slot,
+      handleId,
+      bindsTo: normalizeBinding(bindsTo)
+    });
+  };
+  const registrar = {
+    primaryCta: (handleId, bindsTo) => push("primaryCta", handleId, bindsTo),
+    secondaryCta: (handleId, bindsTo) => push("secondaryCta", handleId, bindsTo),
+    widgetVariant: (handleId, bindsTo) => push("widgetVariant", handleId, bindsTo)
+  };
+  builder(registrar);
+  return { handles };
+}
+
+// src/uiAffordances/mergeAffordances.ts
+function mergeAffordances(registries, opts = {}) {
+  const devMode = !!opts.devMode;
+  const warn = opts.onWarn ?? (() => {
+  });
+  const merged = { handles: registries.flatMap((r) => r.handles) };
+  if (!devMode) return merged;
+  const seenHandleIds = /* @__PURE__ */ new Set();
+  for (const h of merged.handles) {
+    if (seenHandleIds.has(h.handleId)) {
+      throw new Error(`[Taias] Duplicate handleId "${h.handleId}"`);
+    }
+    seenHandleIds.add(h.handleId);
+  }
+  const seenTriples = /* @__PURE__ */ new Set();
+  for (const h of merged.handles) {
+    const k = makeBindingKey(h.slot, h.bindsTo);
+    if (seenTriples.has(k)) {
+      throw new Error(
+        `[Taias] Ambiguous affordance: slot "${h.slot}" has multiple handles bound to (${h.bindsTo.key}="${h.bindsTo.value}")`
+      );
+    }
+    seenTriples.add(k);
+  }
+  warn(`[Taias] Loaded ${merged.handles.length} UI affordance handles`);
+  return merged;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createTaias,
-  defineFlow
+  defineAffordances,
+  defineFlow,
+  mergeAffordances
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/flow.ts","../src/createTaias.ts"],"sourcesContent":["// Main exports\nexport { defineFlow } from \"./flow\";\nexport { createTaias } from \"./createTaias\";\n\n// Type exports\nexport type {\n  TaiasContext,\n  StepDecision,\n  Affordances,\n  StepHandler,\n  FlowStep,\n  FlowDefinition,\n  FlowBuilder,\n  TaiasOptions,\n  Taias,\n} from \"./types\";\n","import type { FlowBuilder, FlowDefinition, FlowStep, StepHandler } from \"./types\";\n\n/**\n * Define a flow with its steps.\n *\n * @param flowId - Unique identifier for the flow\n * @param builder - Callback that receives a FlowBuilder to define steps\n * @returns A FlowDefinition object\n *\n * @example\n * ```ts\n * const onboardRepoFlow = defineFlow(\"onboard_repo\", (flow) => {\n *   flow.step(\"scan_repo\", (ctx) => ({\n *     nextTool: \"configure_app\",\n *   }));\n * });\n * ```\n */\nexport function defineFlow(\n  flowId: string,\n  builder: (flow: FlowBuilder) => void\n): FlowDefinition {\n  const steps: FlowStep[] = [];\n\n  const flowBuilder: FlowBuilder = {\n    step(toolName: string, handler: StepHandler): void {\n      steps.push({ toolName, handler });\n    },\n  };\n\n  builder(flowBuilder);\n\n  return {\n    id: flowId,\n    steps,\n  };\n}\n\n","import type { Affordances, Taias, TaiasContext, TaiasOptions } from \"./types\";\n\n/**\n * Generate advice text for a given next tool.\n */\nfunction generateAdvice(nextTool: string): string {\n  return `FOR THE BEST USER EXPERIENCE, TELL THE USER TO USE THE ${nextTool} TOOL NEXT!!!!!`;\n}\n\n/**\n * Create a Taias instance from a single flow.\n *\n * @param options - Configuration options\n * @returns A Taias instance with a resolve method\n *\n * @example\n * ```ts\n * const taias = createTaias({\n *   flow: onboardRepoFlow,\n *   devMode: process.env.NODE_ENV !== \"production\",\n * });\n *\n * const decision = await taias.resolve({ toolName: \"scan_repo\" });\n * // decision.advice → \"FOR THE BEST USER EXPERIENCE, TELL THE USER TO USE THE configure_app TOOL NEXT!!!!!\"\n * ```\n */\nexport function createTaias(options: TaiasOptions): Taias {\n  const { flow, devMode = false, onMissingStep } = options;\n\n  // Dev mode: Check for duplicate toolNames\n  if (devMode) {\n    const seenTools = new Set<string>();\n    for (const step of flow.steps) {\n      if (seenTools.has(step.toolName)) {\n        throw new Error(\n          `Taias: Duplicate step for tool '${step.toolName}' in flow '${flow.id}'. V1 supports one handler per tool.`\n        );\n      }\n      seenTools.add(step.toolName);\n    }\n  }\n\n  // Build a lookup map for efficient resolution\n  const stepMap = new Map(\n    flow.steps.map((step) => [step.toolName, step.handler])\n  );\n\n  return {\n    async resolve(ctx: TaiasContext): Promise<Affordances | null> {\n      const handler = stepMap.get(ctx.toolName);\n\n      if (!handler) {\n        if (onMissingStep) {\n          onMissingStep(ctx);\n        }\n        return null;\n      }\n\n      const result = await handler(ctx);\n\n      if (!result) {\n        return null;\n      }\n\n      // Dev mode: Warn if nextTool is empty\n      if (devMode && result.nextTool === \"\") {\n        console.warn(`Taias: nextTool for tool '${ctx.toolName}' is empty.`);\n      }\n\n      // Auto-generate the advice text\n      return {\n        advice: generateAdvice(result.nextTool),\n      };\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACkBO,SAAS,WACd,QACA,SACgB;AAChB,QAAM,QAAoB,CAAC;AAE3B,QAAM,cAA2B;AAAA,IAC/B,KAAK,UAAkB,SAA4B;AACjD,YAAM,KAAK,EAAE,UAAU,QAAQ,CAAC;AAAA,IAClC;AAAA,EACF;AAEA,UAAQ,WAAW;AAEnB,SAAO;AAAA,IACL,IAAI;AAAA,IACJ;AAAA,EACF;AACF;;;AC/BA,SAAS,eAAe,UAA0B;AAChD,SAAO,0DAA0D,QAAQ;AAC3E;AAmBO,SAAS,YAAY,SAA8B;AACxD,QAAM,EAAE,MAAM,UAAU,OAAO,cAAc,IAAI;AAGjD,MAAI,SAAS;AACX,UAAM,YAAY,oBAAI,IAAY;AAClC,eAAW,QAAQ,KAAK,OAAO;AAC7B,UAAI,UAAU,IAAI,KAAK,QAAQ,GAAG;AAChC,cAAM,IAAI;AAAA,UACR,mCAAmC,KAAK,QAAQ,cAAc,KAAK,EAAE;AAAA,QACvE;AAAA,MACF;AACA,gBAAU,IAAI,KAAK,QAAQ;AAAA,IAC7B;AAAA,EACF;AAGA,QAAM,UAAU,IAAI;AAAA,IAClB,KAAK,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,UAAU,KAAK,OAAO,CAAC;AAAA,EACxD;AAEA,SAAO;AAAA,IACL,MAAM,QAAQ,KAAgD;AAC5D,YAAM,UAAU,QAAQ,IAAI,IAAI,QAAQ;AAExC,UAAI,CAAC,SAAS;AACZ,YAAI,eAAe;AACjB,wBAAc,GAAG;AAAA,QACnB;AACA,eAAO;AAAA,MACT;AAEA,YAAM,SAAS,MAAM,QAAQ,GAAG;AAEhC,UAAI,CAAC,QAAQ;AACX,eAAO;AAAA,MACT;AAGA,UAAI,WAAW,OAAO,aAAa,IAAI;AACrC,gBAAQ,KAAK,6BAA6B,IAAI,QAAQ,aAAa;AAAA,MACrE;AAGA,aAAO;AAAA,QACL,QAAQ,eAAe,OAAO,QAAQ;AAAA,MACxC;AAAA,IACF;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/flow.ts","../src/uiAffordances/types.ts","../src/uiAffordances/indexing.ts","../src/uiAffordances/select.ts","../src/createTaias.ts","../src/uiAffordances/defineAffordances.ts","../src/uiAffordances/mergeAffordances.ts"],"sourcesContent":["// Main exports\nexport { defineFlow } from \"./flow\";\nexport { createTaias } from \"./createTaias\";\n\n// UI affordances exports\nexport { defineAffordances } from \"./uiAffordances/defineAffordances\";\nexport { mergeAffordances } from \"./uiAffordances/mergeAffordances\";\nexport type {\n  CanonicalSlot,\n  Binding,\n  BindingInput,\n  HandleRegistration,\n  Selection,\n  UiSelections,\n  AffordanceRegistry,\n  SlotMatch,\n} from \"./uiAffordances/types\";\n\n// Core + flow type exports\nexport type {\n  Decision, // moved to core\n  TaiasContext,\n  StepDecision,\n  Affordances,\n  StepHandler,\n  FlowStep,\n  FlowDefinition,\n  FlowBuilder,\n  TaiasOptions,\n  Taias,\n} from \"./types\";\n","import type { FlowBuilder, FlowDefinition, FlowStep, StepHandler } from \"./types\";\n\n/**\n * Define a flow with its steps.\n *\n * @param flowId - Unique identifier for the flow\n * @param builder - Callback that receives a FlowBuilder to define steps\n * @returns A FlowDefinition object\n *\n * @example\n * ```ts\n * const onboardRepoFlow = defineFlow(\"onboard_repo\", (flow) => {\n *   flow.step(\"scan_repo\", (ctx) => ({\n *     nextTool: \"configure_app\",\n *   }));\n * });\n * ```\n */\nexport function defineFlow(\n  flowId: string,\n  builder: (flow: FlowBuilder) => void\n): FlowDefinition {\n  const steps: FlowStep[] = [];\n\n  const flowBuilder: FlowBuilder = {\n    step(toolName: string, handler: StepHandler): void {\n      steps.push({ toolName, handler });\n    },\n  };\n\n  builder(flowBuilder);\n\n  return {\n    id: flowId,\n    steps,\n  };\n}\n\n","export type CanonicalSlot = \"primaryCta\" | \"secondaryCta\" | \"widgetVariant\";\n\nexport type Binding = {\n  key: string;\n  value: string;\n};\n\n/**\n * Input format for registering affordance bindings.\n * - { toolName } is shorthand for { key: \"nextTool\", value: toolName }\n * - { key, value } is the generalized form for custom bindings\n */\nexport type BindingInput = { toolName: string } | { key: string; value: string };\n\nexport type HandleRegistration = {\n  slot: CanonicalSlot;\n  handleId: string;\n  bindsTo: Binding;\n};\n\nexport type Selection = {\n  handleId: string;\n  bindsTo: Binding;\n};\n\nexport type UiSelections = Partial<Record<CanonicalSlot, Selection>>;\n\nexport type AffordanceRegistry = {\n  handles: HandleRegistration[];\n};\n\nexport type SlotMatch = Partial<Record<CanonicalSlot, string>>;\n\nexport function normalizeBinding(input: BindingInput): Binding {\n  if (\"toolName\" in input) return { key: \"nextTool\", value: input.toolName };\n  return { key: input.key, value: input.value };\n}\n\nexport function makeBindingKey(slot: CanonicalSlot, binding: Binding): string {\n  return `${slot}::${binding.key}::${binding.value}`;\n}\n","import type { AffordanceRegistry, HandleRegistration } from \"./types\";\nimport { makeBindingKey } from \"./types\";\n\nexport type RegistryIndex = {\n  byBindingKey: Map<string, HandleRegistration>;\n};\n\nexport function buildRegistryIndex(registry?: AffordanceRegistry): RegistryIndex {\n  const byBindingKey = new Map<string, HandleRegistration>();\n\n  if (!registry) return { byBindingKey };\n\n  for (const h of registry.handles) {\n    byBindingKey.set(makeBindingKey(h.slot, h.bindsTo), h);\n  }\n\n  return { byBindingKey };\n}\n","import type { Decision } from \"../types\";\nimport type { CanonicalSlot, SlotMatch, UiSelections } from \"./types\";\nimport type { RegistryIndex } from \"./indexing\";\nimport { makeBindingKey } from \"./types\";\n\nconst DEFAULT_SLOT_MATCH: Required<Record<CanonicalSlot, string>> = {\n  primaryCta: \"nextTool\",\n  secondaryCta: \"nextTool\",\n  widgetVariant: \"nextTool\",\n};\n\nexport type SelectOptions = {\n  slotMatch?: SlotMatch;\n  devMode?: boolean;\n  onWarn?: (msg: string) => void;\n};\n\nexport function selectUiAffordances(\n  decision: Decision,\n  index: RegistryIndex,\n  opts: SelectOptions = {}\n): UiSelections {\n  const slotMatch = { ...DEFAULT_SLOT_MATCH, ...(opts.slotMatch ?? {}) };\n  const devMode = !!opts.devMode;\n  const warn = opts.onWarn ?? (() => {});\n\n  const selections: UiSelections = {};\n  const slots = Object.keys(DEFAULT_SLOT_MATCH) as CanonicalSlot[];\n\n  for (const slot of slots) {\n    const field = slotMatch[slot];\n    const value = decision[field];\n    if (!value) continue;\n\n    const k = makeBindingKey(slot, { key: field, value });\n    const handle = index.byBindingKey.get(k);\n\n    if (!handle) {\n      if (devMode) warn(`[Taias] No affordance for slot \"${slot}\" when ${field}=\"${value}\"`);\n      continue;\n    }\n\n    selections[slot] = { handleId: handle.handleId, bindsTo: handle.bindsTo };\n  }\n\n  return selections;\n}\n","import type { Affordances, Taias, TaiasContext, TaiasOptions, Decision } from \"./types\";\nimport { buildRegistryIndex } from \"./uiAffordances/indexing\";\nimport { selectUiAffordances } from \"./uiAffordances/select\";\n\n/**\n * Generate advice text for a given next tool.\n */\nfunction generateAdvice(nextTool: string): string {\n  return `FOR THE BEST USER EXPERIENCE, TELL THE USER TO USE THE ${nextTool} TOOL NEXT!!!!!`;\n}\n\n/**\n * createTaias constructs a decision engine.\n *\n * Taias resolves tool context into a generalized Decision object,\n * and then manifests that decision into concrete affordances:\n *\n *   - LLM guidance (advice)\n *   - UI affordance selections\n *\n * Flow logic determines *what should happen next*.\n * UI affordances determine *how that decision appears in the interface*.\n *\n * This file is the boundary where:\n *\n *   Inputs → Decision → Manifestations\n *\n * are unified into a single resolve() call.\n */\nexport function createTaias(options: TaiasOptions): Taias {\n  const {\n    flow,\n    affordances,\n    slotMatch,\n    devMode = false,\n    onMissingStep,\n    onWarn,\n  } = options;\n\n  const warn = onWarn ?? ((msg: string) => console.warn(msg));\n\n  // Dev mode: Check for duplicate toolNames\n  if (devMode) {\n    const seenTools = new Set<string>();\n    for (const step of flow.steps) {\n      if (seenTools.has(step.toolName)) {\n        throw new Error(\n          `Taias: Duplicate step for tool '${step.toolName}' in flow '${flow.id}'. Only one handler per tool is supported.`\n        );\n      }\n      seenTools.add(step.toolName);\n    }\n  }\n\n  // Build a lookup map for efficient resolution\n  const stepMap = new Map(flow.steps.map((step) => [step.toolName, step.handler]));\n\n  // Build affordance index once (if provided)\n  const registryIndex = buildRegistryIndex(affordances);\n\n  return {\n    async resolve(ctx: TaiasContext): Promise<Affordances | null> {\n      const handler = stepMap.get(ctx.toolName);\n\n      if (!handler) {\n        onMissingStep?.(ctx);\n        return null;\n      }\n\n      const result = await handler(ctx);\n      if (!result) return null;\n\n      if (devMode && result.nextTool === \"\") {\n        warn(`Taias: nextTool for tool '${ctx.toolName}' is empty.`);\n      }\n\n      // Build decision object from flow result\n      const decision: Decision = {\n        nextTool: result.nextTool,\n      };\n\n      // Compute UI selections (may be empty if no registry passed)\n      const selections = selectUiAffordances(decision, registryIndex, {\n        devMode,\n        onWarn: warn,\n        slotMatch,\n      });\n\n      return {\n        advice: generateAdvice(result.nextTool),\n        decision,\n        selections,\n      };\n    },\n  };\n}\n","import type {\n    AffordanceRegistry,\n    BindingInput,\n    CanonicalSlot,\n    HandleRegistration,\n  } from \"./types\";\n  import { normalizeBinding } from \"./types\";\n  \n  type RegistrarFn = (handleId: string, bindsTo: BindingInput) => void;\n  \n  export interface AffordanceRegistrar {\n    primaryCta: RegistrarFn;\n    secondaryCta: RegistrarFn;\n    widgetVariant: RegistrarFn;\n  }\n  \n  export function defineAffordances(builder: (r: AffordanceRegistrar) => void): AffordanceRegistry {\n    const handles: HandleRegistration[] = [];\n  \n    const push = (slot: CanonicalSlot, handleId: string, bindsTo: BindingInput) => {\n      handles.push({\n        slot,\n        handleId,\n        bindsTo: normalizeBinding(bindsTo),\n      });\n    };\n  \n    const registrar: AffordanceRegistrar = {\n      primaryCta: (handleId, bindsTo) => push(\"primaryCta\", handleId, bindsTo),\n      secondaryCta: (handleId, bindsTo) => push(\"secondaryCta\", handleId, bindsTo),\n      widgetVariant: (handleId, bindsTo) => push(\"widgetVariant\", handleId, bindsTo),\n    };\n  \n    builder(registrar);\n    return { handles };\n  }\n  ","import type { AffordanceRegistry } from \"./types\";\nimport { makeBindingKey } from \"./types\";\n\nexport type MergeAffordancesOptions = {\n  devMode?: boolean;\n  onWarn?: (msg: string) => void;\n};\n\nexport function mergeAffordances(\n  registries: AffordanceRegistry[],\n  opts: MergeAffordancesOptions = {}\n): AffordanceRegistry {\n  const devMode = !!opts.devMode;\n  const warn = opts.onWarn ?? (() => {});\n\n  const merged: AffordanceRegistry = { handles: registries.flatMap((r) => r.handles) };\n\n  if (!devMode) return merged;\n\n  // Check for duplicate handleIds\n  const seenHandleIds = new Set<string>();\n  for (const h of merged.handles) {\n    if (seenHandleIds.has(h.handleId)) {\n      throw new Error(`[Taias] Duplicate handleId \"${h.handleId}\"`);\n    }\n    seenHandleIds.add(h.handleId);\n  }\n\n  // Check for ambiguous bindings (same slot + key + value)\n  const seenTriples = new Set<string>();\n  for (const h of merged.handles) {\n    const k = makeBindingKey(h.slot, h.bindsTo);\n    if (seenTriples.has(k)) {\n      throw new Error(\n        `[Taias] Ambiguous affordance: slot \"${h.slot}\" has multiple handles bound to (${h.bindsTo.key}=\"${h.bindsTo.value}\")`\n      );\n    }\n    seenTriples.add(k);\n  }\n\n  warn(`[Taias] Loaded ${merged.handles.length} UI affordance handles`);\n  return merged;\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -1,3 +1,39 @@
+type CanonicalSlot = "primaryCta" | "secondaryCta" | "widgetVariant";
+type Binding = {
+    key: string;
+    value: string;
+};
+/**
+ * Input format for registering affordance bindings.
+ * - { toolName } is shorthand for { key: "nextTool", value: toolName }
+ * - { key, value } is the generalized form for custom bindings
+ */
+type BindingInput = {
+    toolName: string;
+} | {
+    key: string;
+    value: string;
+};
+type HandleRegistration = {
+    slot: CanonicalSlot;
+    handleId: string;
+    bindsTo: Binding;
+};
+type Selection = {
+    handleId: string;
+    bindsTo: Binding;
+};
+type UiSelections = Partial<Record<CanonicalSlot, Selection>>;
+type AffordanceRegistry = {
+    handles: HandleRegistration[];
+};
+type SlotMatch = Partial<Record<CanonicalSlot, string>>;
+
+/**
+ * Generalized decision object.
+ * Currently uses decision.nextTool. The structure supports additional keys.
+ */
+type Decision = Record<string, string | undefined>;
 /**
  * Context passed to a step handler.
  */
@@ -11,10 +47,15 @@ type StepDecision = {
     nextTool: string;
 };
 /**
- * Affordances returned by resolve() with auto-generated advice text.
+ * Affordances returned by resolve():
+ * - advice: LLM guidance text
+ * - decision: generalized decision object (currently includes nextTool)
+ * - selections: UI affordance selections (may be empty)
  */
 type Affordances = {
     advice: string;
+    decision: Decision;
+    selections: UiSelections;
 };
 /**
  * Handler function for a flow step.
@@ -46,8 +87,11 @@ interface FlowBuilder {
  */
 type TaiasOptions = {
     flow: FlowDefinition;
+    affordances?: AffordanceRegistry;
+    slotMatch?: SlotMatch;
     devMode?: boolean;
     onMissingStep?: (ctx: TaiasContext) => void;
+    onWarn?: (msg: string) => void;
 };
 /**
  * The Taias instance interface.
@@ -75,22 +119,37 @@ interface Taias {
 declare function defineFlow(flowId: string, builder: (flow: FlowBuilder) => void): FlowDefinition;
 
 /**
- * Create a Taias instance from a single flow.
+ * createTaias constructs a decision engine.
  *
- * @param options - Configuration options
- * @returns A Taias instance with a resolve method
+ * Taias resolves tool context into a generalized Decision object,
+ * and then manifests that decision into concrete affordances:
  *
- * @example
- * ```ts
- * const taias = createTaias({
- *   flow: onboardRepoFlow,
- *   devMode: process.env.NODE_ENV !== "production",
- * });
+ *   - LLM guidance (advice)
+ *   - UI affordance selections
  *
- * const decision = await taias.resolve({ toolName: "scan_repo" });
- * // decision.advice → "FOR THE BEST USER EXPERIENCE, TELL THE USER TO USE THE configure_app TOOL NEXT!!!!!"
- * ```
+ * Flow logic determines *what should happen next*.
+ * UI affordances determine *how that decision appears in the interface*.
+ *
+ * This file is the boundary where:
+ *
+ *   Inputs → Decision → Manifestations
+ *
+ * are unified into a single resolve() call.
  */
 declare function createTaias(options: TaiasOptions): Taias;
 
-export { type Affordances, type FlowBuilder, type FlowDefinition, type FlowStep, type StepDecision, type StepHandler, type Taias, type TaiasContext, type TaiasOptions, createTaias, defineFlow };
+type RegistrarFn = (handleId: string, bindsTo: BindingInput) => void;
+interface AffordanceRegistrar {
+    primaryCta: RegistrarFn;
+    secondaryCta: RegistrarFn;
+    widgetVariant: RegistrarFn;
+}
+declare function defineAffordances(builder: (r: AffordanceRegistrar) => void): AffordanceRegistry;
+
+type MergeAffordancesOptions = {
+    devMode?: boolean;
+    onWarn?: (msg: string) => void;
+};
+declare function mergeAffordances(registries: AffordanceRegistry[], opts?: MergeAffordancesOptions): AffordanceRegistry;
+
+export { type AffordanceRegistry, type Affordances, type Binding, type BindingInput, type CanonicalSlot, type Decision, type FlowBuilder, type FlowDefinition, type FlowStep, type HandleRegistration, type Selection, type SlotMatch, type StepDecision, type StepHandler, type Taias, type TaiasContext, type TaiasOptions, type UiSelections, createTaias, defineAffordances, defineFlow, mergeAffordances };

package/dist/index.d.ts

@@ -1,3 +1,39 @@
+type CanonicalSlot = "primaryCta" | "secondaryCta" | "widgetVariant";
+type Binding = {
+    key: string;
+    value: string;
+};
+/**
+ * Input format for registering affordance bindings.
+ * - { toolName } is shorthand for { key: "nextTool", value: toolName }
+ * - { key, value } is the generalized form for custom bindings
+ */
+type BindingInput = {
+    toolName: string;
+} | {
+    key: string;
+    value: string;
+};
+type HandleRegistration = {
+    slot: CanonicalSlot;
+    handleId: string;
+    bindsTo: Binding;
+};
+type Selection = {
+    handleId: string;
+    bindsTo: Binding;
+};
+type UiSelections = Partial<Record<CanonicalSlot, Selection>>;
+type AffordanceRegistry = {
+    handles: HandleRegistration[];
+};
+type SlotMatch = Partial<Record<CanonicalSlot, string>>;
+
+/**
+ * Generalized decision object.
+ * Currently uses decision.nextTool. The structure supports additional keys.
+ */
+type Decision = Record<string, string | undefined>;
 /**
  * Context passed to a step handler.
  */
@@ -11,10 +47,15 @@ type StepDecision = {
     nextTool: string;
 };
 /**
- * Affordances returned by resolve() with auto-generated advice text.
+ * Affordances returned by resolve():
+ * - advice: LLM guidance text
+ * - decision: generalized decision object (currently includes nextTool)
+ * - selections: UI affordance selections (may be empty)
  */
 type Affordances = {
     advice: string;
+    decision: Decision;
+    selections: UiSelections;
 };
 /**
  * Handler function for a flow step.
@@ -46,8 +87,11 @@ interface FlowBuilder {
  */
 type TaiasOptions = {
     flow: FlowDefinition;
+    affordances?: AffordanceRegistry;
+    slotMatch?: SlotMatch;
     devMode?: boolean;
     onMissingStep?: (ctx: TaiasContext) => void;
+    onWarn?: (msg: string) => void;
 };
 /**
  * The Taias instance interface.
@@ -75,22 +119,37 @@ interface Taias {
 declare function defineFlow(flowId: string, builder: (flow: FlowBuilder) => void): FlowDefinition;
 
 /**
- * Create a Taias instance from a single flow.
+ * createTaias constructs a decision engine.
  *
- * @param options - Configuration options
- * @returns A Taias instance with a resolve method
+ * Taias resolves tool context into a generalized Decision object,
+ * and then manifests that decision into concrete affordances:
  *
- * @example
- * ```ts
- * const taias = createTaias({
- *   flow: onboardRepoFlow,
- *   devMode: process.env.NODE_ENV !== "production",
- * });
+ *   - LLM guidance (advice)
+ *   - UI affordance selections
  *
- * const decision = await taias.resolve({ toolName: "scan_repo" });
- * // decision.advice → "FOR THE BEST USER EXPERIENCE, TELL THE USER TO USE THE configure_app TOOL NEXT!!!!!"
- * ```
+ * Flow logic determines *what should happen next*.
+ * UI affordances determine *how that decision appears in the interface*.
+ *
+ * This file is the boundary where:
+ *
+ *   Inputs → Decision → Manifestations
+ *
+ * are unified into a single resolve() call.
  */
 declare function createTaias(options: TaiasOptions): Taias;
 
-export { type Affordances, type FlowBuilder, type FlowDefinition, type FlowStep, type StepDecision, type StepHandler, type Taias, type TaiasContext, type TaiasOptions, createTaias, defineFlow };
+type RegistrarFn = (handleId: string, bindsTo: BindingInput) => void;
+interface AffordanceRegistrar {
+    primaryCta: RegistrarFn;
+    secondaryCta: RegistrarFn;
+    widgetVariant: RegistrarFn;
+}
+declare function defineAffordances(builder: (r: AffordanceRegistrar) => void): AffordanceRegistry;
+
+type MergeAffordancesOptions = {
+    devMode?: boolean;
+    onWarn?: (msg: string) => void;
+};
+declare function mergeAffordances(registries: AffordanceRegistry[], opts?: MergeAffordancesOptions): AffordanceRegistry;
+
+export { type AffordanceRegistry, type Affordances, type Binding, type BindingInput, type CanonicalSlot, type Decision, type FlowBuilder, type FlowDefinition, type FlowStep, type HandleRegistration, type Selection, type SlotMatch, type StepDecision, type StepHandler, type Taias, type TaiasContext, type TaiasOptions, type UiSelections, createTaias, defineAffordances, defineFlow, mergeAffordances };

package/dist/index.js

@@ -13,50 +13,159 @@ function defineFlow(flowId, builder) {
   };
 }
 
+// src/uiAffordances/types.ts
+function normalizeBinding(input) {
+  if ("toolName" in input) return { key: "nextTool", value: input.toolName };
+  return { key: input.key, value: input.value };
+}
+function makeBindingKey(slot, binding) {
+  return `${slot}::${binding.key}::${binding.value}`;
+}
+
+// src/uiAffordances/indexing.ts
+function buildRegistryIndex(registry) {
+  const byBindingKey = /* @__PURE__ */ new Map();
+  if (!registry) return { byBindingKey };
+  for (const h of registry.handles) {
+    byBindingKey.set(makeBindingKey(h.slot, h.bindsTo), h);
+  }
+  return { byBindingKey };
+}
+
+// src/uiAffordances/select.ts
+var DEFAULT_SLOT_MATCH = {
+  primaryCta: "nextTool",
+  secondaryCta: "nextTool",
+  widgetVariant: "nextTool"
+};
+function selectUiAffordances(decision, index, opts = {}) {
+  const slotMatch = { ...DEFAULT_SLOT_MATCH, ...opts.slotMatch ?? {} };
+  const devMode = !!opts.devMode;
+  const warn = opts.onWarn ?? (() => {
+  });
+  const selections = {};
+  const slots = Object.keys(DEFAULT_SLOT_MATCH);
+  for (const slot of slots) {
+    const field = slotMatch[slot];
+    const value = decision[field];
+    if (!value) continue;
+    const k = makeBindingKey(slot, { key: field, value });
+    const handle = index.byBindingKey.get(k);
+    if (!handle) {
+      if (devMode) warn(`[Taias] No affordance for slot "${slot}" when ${field}="${value}"`);
+      continue;
+    }
+    selections[slot] = { handleId: handle.handleId, bindsTo: handle.bindsTo };
+  }
+  return selections;
+}
+
 // src/createTaias.ts
 function generateAdvice(nextTool) {
   return `FOR THE BEST USER EXPERIENCE, TELL THE USER TO USE THE ${nextTool} TOOL NEXT!!!!!`;
 }
 function createTaias(options) {
-  const { flow, devMode = false, onMissingStep } = options;
+  const {
+    flow,
+    affordances,
+    slotMatch,
+    devMode = false,
+    onMissingStep,
+    onWarn
+  } = options;
+  const warn = onWarn ?? ((msg) => console.warn(msg));
   if (devMode) {
     const seenTools = /* @__PURE__ */ new Set();
     for (const step of flow.steps) {
       if (seenTools.has(step.toolName)) {
         throw new Error(
-          `Taias: Duplicate step for tool '${step.toolName}' in flow '${flow.id}'. V1 supports one handler per tool.`
+          `Taias: Duplicate step for tool '${step.toolName}' in flow '${flow.id}'. Only one handler per tool is supported.`
         );
       }
       seenTools.add(step.toolName);
     }
   }
-  const stepMap = new Map(
-    flow.steps.map((step) => [step.toolName, step.handler])
-  );
+  const stepMap = new Map(flow.steps.map((step) => [step.toolName, step.handler]));
+  const registryIndex = buildRegistryIndex(affordances);
   return {
     async resolve(ctx) {
       const handler = stepMap.get(ctx.toolName);
       if (!handler) {
-        if (onMissingStep) {
-          onMissingStep(ctx);
-        }
+        onMissingStep?.(ctx);
         return null;
       }
       const result = await handler(ctx);
-      if (!result) {
-        return null;
-      }
+      if (!result) return null;
       if (devMode && result.nextTool === "") {
-        console.warn(`Taias: nextTool for tool '${ctx.toolName}' is empty.`);
+        warn(`Taias: nextTool for tool '${ctx.toolName}' is empty.`);
       }
+      const decision = {
+        nextTool: result.nextTool
+      };
+      const selections = selectUiAffordances(decision, registryIndex, {
+        devMode,
+        onWarn: warn,
+        slotMatch
+      });
       return {
-        advice: generateAdvice(result.nextTool)
+        advice: generateAdvice(result.nextTool),
+        decision,
+        selections
       };
     }
   };
 }
+
+// src/uiAffordances/defineAffordances.ts
+function defineAffordances(builder) {
+  const handles = [];
+  const push = (slot, handleId, bindsTo) => {
+    handles.push({
+      slot,
+      handleId,
+      bindsTo: normalizeBinding(bindsTo)
+    });
+  };
+  const registrar = {
+    primaryCta: (handleId, bindsTo) => push("primaryCta", handleId, bindsTo),
+    secondaryCta: (handleId, bindsTo) => push("secondaryCta", handleId, bindsTo),
+    widgetVariant: (handleId, bindsTo) => push("widgetVariant", handleId, bindsTo)
+  };
+  builder(registrar);
+  return { handles };
+}
+
+// src/uiAffordances/mergeAffordances.ts
+function mergeAffordances(registries, opts = {}) {
+  const devMode = !!opts.devMode;
+  const warn = opts.onWarn ?? (() => {
+  });
+  const merged = { handles: registries.flatMap((r) => r.handles) };
+  if (!devMode) return merged;
+  const seenHandleIds = /* @__PURE__ */ new Set();
+  for (const h of merged.handles) {
+    if (seenHandleIds.has(h.handleId)) {
+      throw new Error(`[Taias] Duplicate handleId "${h.handleId}"`);
+    }
+    seenHandleIds.add(h.handleId);
+  }
+  const seenTriples = /* @__PURE__ */ new Set();
+  for (const h of merged.handles) {
+    const k = makeBindingKey(h.slot, h.bindsTo);
+    if (seenTriples.has(k)) {
+      throw new Error(
+        `[Taias] Ambiguous affordance: slot "${h.slot}" has multiple handles bound to (${h.bindsTo.key}="${h.bindsTo.value}")`
+      );
+    }
+    seenTriples.add(k);
+  }
+  warn(`[Taias] Loaded ${merged.handles.length} UI affordance handles`);
+  return merged;
+}
 export {
   createTaias,
-  defineFlow
+  defineAffordances,
+  defineFlow,
+  mergeAffordances
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/flow.ts","../src/createTaias.ts"],"sourcesContent":["import type { FlowBuilder, FlowDefinition, FlowStep, StepHandler } from \"./types\";\n\n/**\n * Define a flow with its steps.\n *\n * @param flowId - Unique identifier for the flow\n * @param builder - Callback that receives a FlowBuilder to define steps\n * @returns A FlowDefinition object\n *\n * @example\n * ```ts\n * const onboardRepoFlow = defineFlow(\"onboard_repo\", (flow) => {\n *   flow.step(\"scan_repo\", (ctx) => ({\n *     nextTool: \"configure_app\",\n *   }));\n * });\n * ```\n */\nexport function defineFlow(\n  flowId: string,\n  builder: (flow: FlowBuilder) => void\n): FlowDefinition {\n  const steps: FlowStep[] = [];\n\n  const flowBuilder: FlowBuilder = {\n    step(toolName: string, handler: StepHandler): void {\n      steps.push({ toolName, handler });\n    },\n  };\n\n  builder(flowBuilder);\n\n  return {\n    id: flowId,\n    steps,\n  };\n}\n\n","import type { Affordances, Taias, TaiasContext, TaiasOptions } from \"./types\";\n\n/**\n * Generate advice text for a given next tool.\n */\nfunction generateAdvice(nextTool: string): string {\n  return `FOR THE BEST USER EXPERIENCE, TELL THE USER TO USE THE ${nextTool} TOOL NEXT!!!!!`;\n}\n\n/**\n * Create a Taias instance from a single flow.\n *\n * @param options - Configuration options\n * @returns A Taias instance with a resolve method\n *\n * @example\n * ```ts\n * const taias = createTaias({\n *   flow: onboardRepoFlow,\n *   devMode: process.env.NODE_ENV !== \"production\",\n * });\n *\n * const decision = await taias.resolve({ toolName: \"scan_repo\" });\n * // decision.advice → \"FOR THE BEST USER EXPERIENCE, TELL THE USER TO USE THE configure_app TOOL NEXT!!!!!\"\n * ```\n */\nexport function createTaias(options: TaiasOptions): Taias {\n  const { flow, devMode = false, onMissingStep } = options;\n\n  // Dev mode: Check for duplicate toolNames\n  if (devMode) {\n    const seenTools = new Set<string>();\n    for (const step of flow.steps) {\n      if (seenTools.has(step.toolName)) {\n        throw new Error(\n          `Taias: Duplicate step for tool '${step.toolName}' in flow '${flow.id}'. V1 supports one handler per tool.`\n        );\n      }\n      seenTools.add(step.toolName);\n    }\n  }\n\n  // Build a lookup map for efficient resolution\n  const stepMap = new Map(\n    flow.steps.map((step) => [step.toolName, step.handler])\n  );\n\n  return {\n    async resolve(ctx: TaiasContext): Promise<Affordances | null> {\n      const handler = stepMap.get(ctx.toolName);\n\n      if (!handler) {\n        if (onMissingStep) {\n          onMissingStep(ctx);\n        }\n        return null;\n      }\n\n      const result = await handler(ctx);\n\n      if (!result) {\n        return null;\n      }\n\n      // Dev mode: Warn if nextTool is empty\n      if (devMode && result.nextTool === \"\") {\n        console.warn(`Taias: nextTool for tool '${ctx.toolName}' is empty.`);\n      }\n\n      // Auto-generate the advice text\n      return {\n        advice: generateAdvice(result.nextTool),\n      };\n    },\n  };\n}\n"],"mappings":";AAkBO,SAAS,WACd,QACA,SACgB;AAChB,QAAM,QAAoB,CAAC;AAE3B,QAAM,cAA2B;AAAA,IAC/B,KAAK,UAAkB,SAA4B;AACjD,YAAM,KAAK,EAAE,UAAU,QAAQ,CAAC;AAAA,IAClC;AAAA,EACF;AAEA,UAAQ,WAAW;AAEnB,SAAO;AAAA,IACL,IAAI;AAAA,IACJ;AAAA,EACF;AACF;;;AC/BA,SAAS,eAAe,UAA0B;AAChD,SAAO,0DAA0D,QAAQ;AAC3E;AAmBO,SAAS,YAAY,SAA8B;AACxD,QAAM,EAAE,MAAM,UAAU,OAAO,cAAc,IAAI;AAGjD,MAAI,SAAS;AACX,UAAM,YAAY,oBAAI,IAAY;AAClC,eAAW,QAAQ,KAAK,OAAO;AAC7B,UAAI,UAAU,IAAI,KAAK,QAAQ,GAAG;AAChC,cAAM,IAAI;AAAA,UACR,mCAAmC,KAAK,QAAQ,cAAc,KAAK,EAAE;AAAA,QACvE;AAAA,MACF;AACA,gBAAU,IAAI,KAAK,QAAQ;AAAA,IAC7B;AAAA,EACF;AAGA,QAAM,UAAU,IAAI;AAAA,IAClB,KAAK,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,UAAU,KAAK,OAAO,CAAC;AAAA,EACxD;AAEA,SAAO;AAAA,IACL,MAAM,QAAQ,KAAgD;AAC5D,YAAM,UAAU,QAAQ,IAAI,IAAI,QAAQ;AAExC,UAAI,CAAC,SAAS;AACZ,YAAI,eAAe;AACjB,wBAAc,GAAG;AAAA,QACnB;AACA,eAAO;AAAA,MACT;AAEA,YAAM,SAAS,MAAM,QAAQ,GAAG;AAEhC,UAAI,CAAC,QAAQ;AACX,eAAO;AAAA,MACT;AAGA,UAAI,WAAW,OAAO,aAAa,IAAI;AACrC,gBAAQ,KAAK,6BAA6B,IAAI,QAAQ,aAAa;AAAA,MACrE;AAGA,aAAO;AAAA,QACL,QAAQ,eAAe,OAAO,QAAQ;AAAA,MACxC;AAAA,IACF;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../src/flow.ts","../src/uiAffordances/types.ts","../src/uiAffordances/indexing.ts","../src/uiAffordances/select.ts","../src/createTaias.ts","../src/uiAffordances/defineAffordances.ts","../src/uiAffordances/mergeAffordances.ts"],"sourcesContent":["import type { FlowBuilder, FlowDefinition, FlowStep, StepHandler } from \"./types\";\n\n/**\n * Define a flow with its steps.\n *\n * @param flowId - Unique identifier for the flow\n * @param builder - Callback that receives a FlowBuilder to define steps\n * @returns A FlowDefinition object\n *\n * @example\n * ```ts\n * const onboardRepoFlow = defineFlow(\"onboard_repo\", (flow) => {\n *   flow.step(\"scan_repo\", (ctx) => ({\n *     nextTool: \"configure_app\",\n *   }));\n * });\n * ```\n */\nexport function defineFlow(\n  flowId: string,\n  builder: (flow: FlowBuilder) => void\n): FlowDefinition {\n  const steps: FlowStep[] = [];\n\n  const flowBuilder: FlowBuilder = {\n    step(toolName: string, handler: StepHandler): void {\n      steps.push({ toolName, handler });\n    },\n  };\n\n  builder(flowBuilder);\n\n  return {\n    id: flowId,\n    steps,\n  };\n}\n\n","export type CanonicalSlot = \"primaryCta\" | \"secondaryCta\" | \"widgetVariant\";\n\nexport type Binding = {\n  key: string;\n  value: string;\n};\n\n/**\n * Input format for registering affordance bindings.\n * - { toolName } is shorthand for { key: \"nextTool\", value: toolName }\n * - { key, value } is the generalized form for custom bindings\n */\nexport type BindingInput = { toolName: string } | { key: string; value: string };\n\nexport type HandleRegistration = {\n  slot: CanonicalSlot;\n  handleId: string;\n  bindsTo: Binding;\n};\n\nexport type Selection = {\n  handleId: string;\n  bindsTo: Binding;\n};\n\nexport type UiSelections = Partial<Record<CanonicalSlot, Selection>>;\n\nexport type AffordanceRegistry = {\n  handles: HandleRegistration[];\n};\n\nexport type SlotMatch = Partial<Record<CanonicalSlot, string>>;\n\nexport function normalizeBinding(input: BindingInput): Binding {\n  if (\"toolName\" in input) return { key: \"nextTool\", value: input.toolName };\n  return { key: input.key, value: input.value };\n}\n\nexport function makeBindingKey(slot: CanonicalSlot, binding: Binding): string {\n  return `${slot}::${binding.key}::${binding.value}`;\n}\n","import type { AffordanceRegistry, HandleRegistration } from \"./types\";\nimport { makeBindingKey } from \"./types\";\n\nexport type RegistryIndex = {\n  byBindingKey: Map<string, HandleRegistration>;\n};\n\nexport function buildRegistryIndex(registry?: AffordanceRegistry): RegistryIndex {\n  const byBindingKey = new Map<string, HandleRegistration>();\n\n  if (!registry) return { byBindingKey };\n\n  for (const h of registry.handles) {\n    byBindingKey.set(makeBindingKey(h.slot, h.bindsTo), h);\n  }\n\n  return { byBindingKey };\n}\n","import type { Decision } from \"../types\";\nimport type { CanonicalSlot, SlotMatch, UiSelections } from \"./types\";\nimport type { RegistryIndex } from \"./indexing\";\nimport { makeBindingKey } from \"./types\";\n\nconst DEFAULT_SLOT_MATCH: Required<Record<CanonicalSlot, string>> = {\n  primaryCta: \"nextTool\",\n  secondaryCta: \"nextTool\",\n  widgetVariant: \"nextTool\",\n};\n\nexport type SelectOptions = {\n  slotMatch?: SlotMatch;\n  devMode?: boolean;\n  onWarn?: (msg: string) => void;\n};\n\nexport function selectUiAffordances(\n  decision: Decision,\n  index: RegistryIndex,\n  opts: SelectOptions = {}\n): UiSelections {\n  const slotMatch = { ...DEFAULT_SLOT_MATCH, ...(opts.slotMatch ?? {}) };\n  const devMode = !!opts.devMode;\n  const warn = opts.onWarn ?? (() => {});\n\n  const selections: UiSelections = {};\n  const slots = Object.keys(DEFAULT_SLOT_MATCH) as CanonicalSlot[];\n\n  for (const slot of slots) {\n    const field = slotMatch[slot];\n    const value = decision[field];\n    if (!value) continue;\n\n    const k = makeBindingKey(slot, { key: field, value });\n    const handle = index.byBindingKey.get(k);\n\n    if (!handle) {\n      if (devMode) warn(`[Taias] No affordance for slot \"${slot}\" when ${field}=\"${value}\"`);\n      continue;\n    }\n\n    selections[slot] = { handleId: handle.handleId, bindsTo: handle.bindsTo };\n  }\n\n  return selections;\n}\n","import type { Affordances, Taias, TaiasContext, TaiasOptions, Decision } from \"./types\";\nimport { buildRegistryIndex } from \"./uiAffordances/indexing\";\nimport { selectUiAffordances } from \"./uiAffordances/select\";\n\n/**\n * Generate advice text for a given next tool.\n */\nfunction generateAdvice(nextTool: string): string {\n  return `FOR THE BEST USER EXPERIENCE, TELL THE USER TO USE THE ${nextTool} TOOL NEXT!!!!!`;\n}\n\n/**\n * createTaias constructs a decision engine.\n *\n * Taias resolves tool context into a generalized Decision object,\n * and then manifests that decision into concrete affordances:\n *\n *   - LLM guidance (advice)\n *   - UI affordance selections\n *\n * Flow logic determines *what should happen next*.\n * UI affordances determine *how that decision appears in the interface*.\n *\n * This file is the boundary where:\n *\n *   Inputs → Decision → Manifestations\n *\n * are unified into a single resolve() call.\n */\nexport function createTaias(options: TaiasOptions): Taias {\n  const {\n    flow,\n    affordances,\n    slotMatch,\n    devMode = false,\n    onMissingStep,\n    onWarn,\n  } = options;\n\n  const warn = onWarn ?? ((msg: string) => console.warn(msg));\n\n  // Dev mode: Check for duplicate toolNames\n  if (devMode) {\n    const seenTools = new Set<string>();\n    for (const step of flow.steps) {\n      if (seenTools.has(step.toolName)) {\n        throw new Error(\n          `Taias: Duplicate step for tool '${step.toolName}' in flow '${flow.id}'. Only one handler per tool is supported.`\n        );\n      }\n      seenTools.add(step.toolName);\n    }\n  }\n\n  // Build a lookup map for efficient resolution\n  const stepMap = new Map(flow.steps.map((step) => [step.toolName, step.handler]));\n\n  // Build affordance index once (if provided)\n  const registryIndex = buildRegistryIndex(affordances);\n\n  return {\n    async resolve(ctx: TaiasContext): Promise<Affordances | null> {\n      const handler = stepMap.get(ctx.toolName);\n\n      if (!handler) {\n        onMissingStep?.(ctx);\n        return null;\n      }\n\n      const result = await handler(ctx);\n      if (!result) return null;\n\n      if (devMode && result.nextTool === \"\") {\n        warn(`Taias: nextTool for tool '${ctx.toolName}' is empty.`);\n      }\n\n      // Build decision object from flow result\n      const decision: Decision = {\n        nextTool: result.nextTool,\n      };\n\n      // Compute UI selections (may be empty if no registry passed)\n      const selections = selectUiAffordances(decision, registryIndex, {\n        devMode,\n        onWarn: warn,\n        slotMatch,\n      });\n\n      return {\n        advice: generateAdvice(result.nextTool),\n        decision,\n        selections,\n      };\n    },\n  };\n}\n","import type {\n    AffordanceRegistry,\n    BindingInput,\n    CanonicalSlot,\n    HandleRegistration,\n  } from \"./types\";\n  import { normalizeBinding } from \"./types\";\n  \n  type RegistrarFn = (handleId: string, bindsTo: BindingInput) => void;\n  \n  export interface AffordanceRegistrar {\n    primaryCta: RegistrarFn;\n    secondaryCta: RegistrarFn;\n    widgetVariant: RegistrarFn;\n  }\n  \n  export function defineAffordances(builder: (r: AffordanceRegistrar) => void): AffordanceRegistry {\n    const handles: HandleRegistration[] = [];\n  \n    const push = (slot: CanonicalSlot, handleId: string, bindsTo: BindingInput) => {\n      handles.push({\n        slot,\n        handleId,\n        bindsTo: normalizeBinding(bindsTo),\n      });\n    };\n  \n    const registrar: AffordanceRegistrar = {\n      primaryCta: (handleId, bindsTo) => push(\"primaryCta\", handleId, bindsTo),\n      secondaryCta: (handleId, bindsTo) => push(\"secondaryCta\", handleId, bindsTo),\n      widgetVariant: (handleId, bindsTo) => push(\"widgetVariant\", handleId, bindsTo),\n    };\n  \n    builder(registrar);\n    return { handles };\n  }\n  ","import type { AffordanceRegistry } from \"./types\";\nimport { makeBindingKey } from \"./types\";\n\nexport type MergeAffordancesOptions = {\n  devMode?: boolean;\n  onWarn?: (msg: string) => void;\n};\n\nexport function mergeAffordances(\n  registries: AffordanceRegistry[],\n  opts: MergeAffordancesOptions = {}\n): AffordanceRegistry {\n  const devMode = !!opts.devMode;\n  const warn = opts.onWarn ?? (() => {});\n\n  const merged: AffordanceRegistry = { handles: registries.flatMap((r) => r.handles) };\n\n  if (!devMode) return merged;\n\n  // Check for duplicate handleIds\n  const seenHandleIds = new Set<string>();\n  for (const h of merged.handles) {\n    if (seenHandleIds.has(h.handleId)) {\n      throw new Error(`[Taias] Duplicate handleId \"${h.handleId}\"`);\n    }\n    seenHandleIds.add(h.handleId);\n  }\n\n  // Check for ambiguous bindings (same slot + key + value)\n  const seenTriples = new Set<string>();\n  for (const h of merged.handles) {\n    const k = makeBindingKey(h.slot, h.bindsTo);\n    if (seenTriples.has(k)) {\n      throw new Error(\n        `[Taias] Ambiguous affordance: slot \"${h.slot}\" has multiple handles bound to (${h.bindsTo.key}=\"${h.bindsTo.value}\")`\n      );\n    }\n    seenTriples.add(k);\n  }\n\n  warn(`[Taias] Loaded ${merged.handles.length} UI affordance handles`);\n  return merged;\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taias",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "type": "module",
   "description": "Taias - Give your MCP server an opinion, guide your users to achieve outcomes",
   "license": "Apache-2.0",