taias

Taias is a lightweight framework that helps MCP server builders influence and shape user experiences inside LLM-driven interfaces.

Installation

``bash
npm install taias
`

Quick Start

1. Define a flow — Map out your tool sequence:

`ts
import { defineFlow, createTaias } from "taias";

const flow = defineFlow("onboard", (flow) => {
flow.step("scan_repo", () => ({ nextTool: "configure_app" }));
flow.step("configure_app", () => ({ nextTool: "deploy" }));
});
`

2. Create a Taias instance:

`ts
const taias = createTaias({
flow,
devMode: true, // Enable validation and warnings during development
onMissingStep: ({ toolName }) => {
console.warn([Taias] No step defined for tool "${toolName}");
},
});
`

3. Append advice to your tool response:

`ts
// Inside your tool handler

const affordances = await taias.resolve({ toolName: "scan_repo" });

let message = "Scan successful!";

// Append Taias advice to guide the LLM to the next step
if (affordances?.advice) {
message += \n\n${affordances.advice};
}

return {
content: [
{
type: "text",
text: message,
},
],
};
`

API

$3

Creates a flow definition.

`ts
const myFlow = defineFlow("my_flow", (flow) => {
flow.step("tool_name", (ctx) => ({
nextTool: "next_tool_name",
}));
});
`

Parameters:
- flowId - Unique identifier for the flow
- builder - Callback receiving a FlowBuilder to define steps

Returns: FlowDefinition

$3

Creates a Taias instance from a flow.

`ts
const taias = createTaias({
flow: myFlow,
devMode: true,
onMissingStep: (ctx) => {
console.log(No next step for tool: ${ctx.toolName});
},
});
`

Options:
- flow - A FlowDefinition created by defineFlow
- devMode (optional) - Enable development mode checks
- onMissingStep (optional) - Callback invoked when no step matches

Returns: Taias instance

$3

Resolves a tool call to get the suggested next step. Advice text to send the LLM is generated based on the nextTool specified in your step handler.

`ts
const affordances = await taias.resolve({ toolName: "scan_repo" });
// affordances.advice → "FOR THE BEST USER EXPERIENCE, TELL THE USER TO USE THE configure_app TOOL NEXT!!!!!"
`

> The emphasis helps LLMs prioritize it.

Parameters:
- ctx.toolName - The name of the tool being called

Returns: Affordances | null
- Returns an Affordances object with advice (and more) if a matching step is found
- Returns null if no step matches or handler returns null

See the full documentation for complete API reference and types.

Dev Mode

See the full documentation for more details.

Documentation

Full Documentation

License

Apache License 2.0