tomevault-io Add Specialists
Configure AI and human participants in a decision process.
Built-in Proposer Strategies
| Strategy Name | Description |
|---|---|
firstAvailable |
Always picks the first available transition |
lastAvailable |
Always picks the last available transition |
random |
Randomly selects a transition |
Built-in Arbiter Strategies
| Strategy Name | Description |
|---|---|
alignmentMargin |
Alignment-weighted margin consensus (default threshold: 1) |
firstProposal |
Accepts the first proposal submitted |
Machine-Level Specialists (JSON)
{
"machineName": "code-review",
"initialState": "pending",
"goalState": "approved",
"specialists": [
{
"specialistId": "ai-proposer",
"role": "proposer",
"strategyFnName": "firstAvailable"
},
{
"specialistId": "review-arbiter",
"role": "arbiter",
"strategyFnName": "alignmentMargin",
"threshold": 0.5
}
],
"states": { ... }
}
Programmatic Registration
import { registerProposer, registerArbiter } from "dialai";
// AI proposer with built-in strategy
await registerProposer({
specialistId: "ai-proposer",
machineName: "code-review",
strategyFnName: "firstAvailable",
});
// Human specialist (can force arbitration)
await registerProposer({
specialistId: "human-reviewer",
machineName: "code-review",
isHuman: true,
strategyFnName: "firstAvailable",
});
// LLM-based proposer with context function
await registerProposer({
specialistId: "llm-proposer",
machineName: "code-review",
modelId: "openai/gpt-4o-mini",
contextFn: async (ctx) => `Review this: state=${ctx.currentState}`,
});
// Arbiter with alignment margin
await registerArbiter({
specialistId: "consensus-arbiter",
machineName: "code-review",
strategyFnName: "alignmentMargin",
threshold: 0.5,
});
Patterns
Human Override
AI proposes, human has final say:
await registerProposer({
specialistId: "ai",
machineName: "review",
strategyFnName: "firstAvailable",
});
await registerProposer({
specialistId: "human",
machineName: "review",
isHuman: true,
strategyFnName: "firstAvailable",
});
Human proposals always win via submitArbitration with an explicit transitionName.
AI Consensus
Multiple AI proposers with alignment margin:
await registerProposer({ specialistId: "ai-1", machineName: "review", strategyFnName: "firstAvailable" });
await registerProposer({ specialistId: "ai-2", machineName: "review", strategyFnName: "random" });
await registerProposer({ specialistId: "ai-3", machineName: "review", strategyFnName: "lastAvailable" });
await registerArbiter({
specialistId: "arbiter",
machineName: "review",
strategyFnName: "alignmentMargin",
threshold: 0.5,
});
Converted and distributed by TomeVault — claim your Tome and manage your conversions.