@gobing-ai/ts-ai-decision 0.5.13

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC7G,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjF,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGlF,wHAAwH;AACxH,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;AAEzF,4GAA4G;AAC5G,MAAM,WAAW,mBAAmB;IAChC,oGAAoG;IACpG,QAAQ,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,oBAAoB,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC,CAAC;IACnF,mHAAmH;IACnH,QAAQ,CAAC,aAAa,CAAC,EAAE;QAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC;QAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,iBAAiB,CAAA;KAAE,CAAC;CACjH;AAID;;;;;;;;GAQG;AACH,qBAAa,qBAAqB;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAGpB;IAEJ,sFAAsF;gBAC1E,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,mBAAmB,GAAG,KAAK,CAAA;KAAE;IAYhE,oGAAoG;IACpG,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI;IAWjD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,KAAK,IAAI,MAAM,EAAE;IAIjB;;;;OAIG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CA2BtD"}

package/dist/registry.js

@@ -0,0 +1,74 @@
+import { createDecisionMaker } from '@gobing-ai/ts-ai-runner';
+import { createFmDriver } from '@gobing-ai/ts-decision-fm';
+import { createLayaDriver } from '@gobing-ai/ts-laya-mlx';
+import { DecisionRegistryError, UnknownDecisionMakerError } from './errors.js';
+const NAME_PATTERN = /^[a-z][a-z0-9-]*$/;
+/**
+ * Registry mapping plain names to {@link DecisionMaker}s (task 0091, ADR-033
+ * § Maker registry). Built-ins are registered as lazy factories, so
+ * `register`, `has` and `names` never construct a maker or driver; the first
+ * `resolve` runs the factory and memoises the maker, while a failed factory
+ * stays un-memoised so a later resolve retries (e.g. a model not yet
+ * downloaded). No catalog dependency — catalog code depends on this, never
+ * the reverse.
+ */
+export class DecisionMakerRegistry {
+    entries = new Map();
+    /** Pre-registers `typesafe`, `fm-local` and `laya-local` unless `builtins: false`. */
+    constructor(options) {
+        if (options?.builtins === false)
+            return;
+        const { makerOptions = {}, driverOptions = {} } = options?.builtins ?? {};
+        this.register('typesafe', () => createDecisionMaker({ backend: 'typesafe', ...makerOptions }));
+        this.register('fm-local', () => createDecisionMaker({ driver: createFmDriver(driverOptions['fm-local'] ?? {}), ...makerOptions }));
+        this.register('laya-local', () => createDecisionMaker({ driver: createLayaDriver(driverOptions['laya-local'] ?? {}), ...makerOptions }));
+    }
+    /** Register a maker or factory under `name`; chains. Throws on a bad or already-registered name. */
+    register(name, source) {
+        if (!NAME_PATTERN.test(name)) {
+            throw new DecisionRegistryError(`Invalid decision maker name '${name}' — must match ${NAME_PATTERN}.`);
+        }
+        if (this.entries.has(name)) {
+            throw new DecisionRegistryError(`Decision maker '${name}' is already registered.`);
+        }
+        this.entries.set(name, { source });
+        return this;
+    }
+    has(name) {
+        return this.entries.has(name);
+    }
+    names() {
+        return [...this.entries.keys()];
+    }
+    /**
+     * Resolve `name` to a maker, running and memoising a factory on first use. Factory errors
+     * propagate unchanged. Concurrent resolves of one name share a single in-flight factory run
+     * so every caller gets the same instance; a rejected run is cleared so a later resolve retries.
+     */
+    async resolve(name) {
+        const entry = this.entries.get(name);
+        if (entry === undefined) {
+            throw new UnknownDecisionMakerError(`Unknown decision maker '${name}' — register it or use a built-in.`, name);
+        }
+        if (entry.maker)
+            return entry.maker;
+        // A check-then-set across `await` would let two concurrent callers run the factory and
+        // receive different instances, so the run itself is memoised while in flight. The
+        // rejection teardown attaches via .catch instead of a try/finally inside the run: with a
+        // finally-based clear, Bun's test runner reports the settled rejection as an unhandled
+        // error when a later resolve retries (false positive).
+        if (!entry.pending) {
+            const run = (async () => {
+                const maker = typeof entry.source === 'function' ? await entry.source() : entry.source;
+                entry.maker = maker;
+                return maker;
+            })();
+            run.catch(() => {
+                if (entry.pending === run)
+                    entry.pending = undefined; // allow a later resolve to retry
+            });
+            entry.pending = run;
+        }
+        return await entry.pending;
+    }
+}

package/dist/schema.d.ts

@@ -0,0 +1,137 @@
+import type { Desc } from '@gobing-ai/ts-ai-runner';
+import { z } from 'zod';
+/**
+ * Zod schema for the decision catalog — the runtime source of truth (task 0089 R4).
+ * `schemas/decision-catalog.schema.json` describes the same shape for editors and
+ * standard validators; strictness (`additionalProperties: false` / `.strict()`) applies
+ * at every level. Cross-field semantics (fallback vocabulary, template refs, defaults,
+ * reserved `instructions`) are enforced by the loader in `catalog.ts`.
+ */
+export declare const DECISION_ID_PATTERN: RegExp;
+/** Declared parameter names: lowercase-start identifier, no hyphens. */
+export declare const PARAM_NAME_PATTERN: RegExp;
+/** Maker registry names: lowercase kebab-case. */
+export declare const MAKER_NAME_PATTERN: RegExp;
+/** Full parameter form; the shorthand is the bare {@link ParamTypeSchema} string. */
+declare const FullParamSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        string: "string";
+        number: "number";
+        boolean: "boolean";
+        enum: "enum";
+        json: "json";
+    }>;
+    default: z.ZodOptional<z.ZodUnknown>;
+    values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/** Authored parameter form: the bare type shorthand or the full strict object. */
+export declare const ParamSchema: z.ZodUnion<readonly [z.ZodEnum<{
+    string: "string";
+    number: "number";
+    boolean: "boolean";
+    enum: "enum";
+    json: "json";
+}>, z.ZodObject<{
+    type: z.ZodEnum<{
+        string: "string";
+        number: "number";
+        boolean: "boolean";
+        enum: "enum";
+        json: "json";
+    }>;
+    default: z.ZodOptional<z.ZodUnknown>;
+    values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>]>;
+/** One authored decision (strict; cross-field semantics are enforced by the loader in `catalog.ts`). */
+export declare const DecisionSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        choice: "choice";
+        score: "score";
+        noul: "noul";
+    }>;
+    description: z.ZodOptional<z.ZodString>;
+    instructions: z.ZodOptional<z.ZodType<Desc, unknown, z.core.$ZodTypeInternals<Desc, unknown>>>;
+    parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodEnum<{
+        string: "string";
+        number: "number";
+        boolean: "boolean";
+        enum: "enum";
+        json: "json";
+    }>, z.ZodObject<{
+        type: z.ZodEnum<{
+            string: "string";
+            number: "number";
+            boolean: "boolean";
+            enum: "enum";
+            json: "json";
+        }>;
+        default: z.ZodOptional<z.ZodUnknown>;
+        values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>]>>>;
+    criteria: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        true: z.ZodOptional<z.ZodType<Desc, unknown, z.core.$ZodTypeInternals<Desc, unknown>>>;
+        false: z.ZodOptional<z.ZodType<Desc, unknown, z.core.$ZodTypeInternals<Desc, unknown>>>;
+    }, z.core.$strict>, z.ZodRecord<z.ZodString, z.ZodType<Desc, unknown, z.core.$ZodTypeInternals<Desc, unknown>>>, z.ZodArray<z.ZodType<Desc, unknown, z.core.$ZodTypeInternals<Desc, unknown>>>]>>;
+    fallback: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
+    minConfidence: z.ZodOptional<z.ZodNumber>;
+    maker: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/** Whole-catalog schema (strict; `version` must be 1 and at least one decision is required). */
+export declare const DecisionCatalogSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    version: z.ZodLiteral<1>;
+    defaults: z.ZodOptional<z.ZodObject<{
+        maker: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+        minConfidence: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    decisions: z.ZodRecord<z.ZodString, z.ZodObject<{
+        type: z.ZodEnum<{
+            choice: "choice";
+            score: "score";
+            noul: "noul";
+        }>;
+        description: z.ZodOptional<z.ZodString>;
+        instructions: z.ZodOptional<z.ZodType<Desc, unknown, z.core.$ZodTypeInternals<Desc, unknown>>>;
+        parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodEnum<{
+            string: "string";
+            number: "number";
+            boolean: "boolean";
+            enum: "enum";
+            json: "json";
+        }>, z.ZodObject<{
+            type: z.ZodEnum<{
+                string: "string";
+                number: "number";
+                boolean: "boolean";
+                enum: "enum";
+                json: "json";
+            }>;
+            default: z.ZodOptional<z.ZodUnknown>;
+            values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>]>>>;
+        criteria: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            true: z.ZodOptional<z.ZodType<Desc, unknown, z.core.$ZodTypeInternals<Desc, unknown>>>;
+            false: z.ZodOptional<z.ZodType<Desc, unknown, z.core.$ZodTypeInternals<Desc, unknown>>>;
+        }, z.core.$strict>, z.ZodRecord<z.ZodString, z.ZodType<Desc, unknown, z.core.$ZodTypeInternals<Desc, unknown>>>, z.ZodArray<z.ZodType<Desc, unknown, z.core.$ZodTypeInternals<Desc, unknown>>>]>>;
+        fallback: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
+        minConfidence: z.ZodOptional<z.ZodNumber>;
+        maker: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+/** Inferred shape of a validated catalog body. */
+export type ParsedCatalog = z.infer<typeof DecisionCatalogSchema>;
+/** Inferred shape of one validated decision body. */
+export type ParsedDecision = z.infer<typeof DecisionSchema>;
+/** Inferred shape of the full (non-shorthand) parameter form. */
+export type ParsedParam = z.infer<typeof FullParamSchema>;
+/** The whole parameter union: the shorthand type string or the full form. */
+export type ParsedParamUnion = z.infer<typeof ParamSchema>;
+export {};
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAQ,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;GAMG;AAEH,eAAO,MAAM,mBAAmB,QAAuB,CAAC;AACxD,wEAAwE;AACxE,eAAO,MAAM,kBAAkB,QAAyB,CAAC;AACzD,kDAAkD;AAClD,eAAO,MAAM,kBAAkB,QAAsB,CAAC;AAoBtD,qFAAqF;AACrF,QAAA,MAAM,eAAe;;;;;;;;;;;kBAOR,CAAC;AAEd,kFAAkF;AAClF,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;oBAA8C,CAAC;AAMvE,wGAAwG;AACxG,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAYd,CAAC;AAEd,gGAAgG;AAChG,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAiB5B,CAAC;AAEP,kDAAkD;AAClD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAClE,qDAAqD;AACrD,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAC5D,iEAAiE;AACjE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAC1D,6EAA6E;AAC7E,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC"}

package/dist/schema.js

@@ -0,0 +1,71 @@
+import { z } from 'zod';
+/**
+ * Zod schema for the decision catalog — the runtime source of truth (task 0089 R4).
+ * `schemas/decision-catalog.schema.json` describes the same shape for editors and
+ * standard validators; strictness (`additionalProperties: false` / `.strict()`) applies
+ * at every level. Cross-field semantics (fallback vocabulary, template refs, defaults,
+ * reserved `instructions`) are enforced by the loader in `catalog.ts`.
+ */
+export const DECISION_ID_PATTERN = /^[a-z][a-z0-9_-]*$/;
+/** Declared parameter names: lowercase-start identifier, no hyphens. */
+export const PARAM_NAME_PATTERN = /^[a-z][a-zA-Z0-9_]*$/;
+/** Maker registry names: lowercase kebab-case. */
+export const MAKER_NAME_PATTERN = /^[a-z][a-z0-9-]*$/;
+const JsonValueSchema = z.lazy(() => z.union([
+    z.string(),
+    z.number(),
+    z.boolean(),
+    z.null(),
+    z.array(JsonValueSchema),
+    z.record(z.string(), JsonValueSchema),
+]));
+/** A Jev entry: string, JSON object, JSON array, or null ("left undescribed"). */
+const JevEntrySchema = z.lazy(() => z.union([z.string(), z.null(), z.array(JsonValueSchema), z.record(z.string(), JsonValueSchema)]));
+const ParamTypeSchema = z.enum(['string', 'number', 'boolean', 'enum', 'json']);
+/** Full parameter form; the shorthand is the bare {@link ParamTypeSchema} string. */
+const FullParamSchema = z
+    .object({
+    type: ParamTypeSchema,
+    default: z.unknown().optional(),
+    values: z.array(z.string()).min(1).optional(),
+    description: z.string().optional(),
+})
+    .strict();
+/** Authored parameter form: the bare type shorthand or the full strict object. */
+export const ParamSchema = z.union([ParamTypeSchema, FullParamSchema]);
+const NoulCriteriaSchema = z.object({ true: JevEntrySchema.optional(), false: JevEntrySchema.optional() }).strict();
+const ChoiceCriteriaSchema = z.record(z.string().min(1), JevEntrySchema);
+const ScoreCriteriaSchema = z.array(JevEntrySchema);
+/** One authored decision (strict; cross-field semantics are enforced by the loader in `catalog.ts`). */
+export const DecisionSchema = z
+    .object({
+    type: z.enum(['choice', 'score', 'noul']),
+    description: z.string().optional(),
+    instructions: JevEntrySchema.optional(),
+    parameters: z.record(z.string().regex(PARAM_NAME_PATTERN), ParamSchema).optional(),
+    criteria: z.union([NoulCriteriaSchema, ChoiceCriteriaSchema, ScoreCriteriaSchema]).optional(),
+    fallback: z.union([z.string(), z.number(), z.boolean()]),
+    minConfidence: z.number().min(0).max(1).optional(),
+    maker: z.string().regex(MAKER_NAME_PATTERN).optional(),
+    model: z.string().optional(),
+})
+    .strict();
+/** Whole-catalog schema (strict; `version` must be 1 and at least one decision is required). */
+export const DecisionCatalogSchema = z
+    .object({
+    $schema: z.string().optional(),
+    version: z.literal(1),
+    defaults: z
+        .object({
+        maker: z.string().regex(MAKER_NAME_PATTERN).optional(),
+        model: z.string().optional(),
+        minConfidence: z.number().min(0).max(1).optional(),
+    })
+        .strict()
+        .optional(),
+    decisions: z.record(z.string().regex(DECISION_ID_PATTERN), DecisionSchema),
+})
+    .strict()
+    .refine((catalog) => Object.keys(catalog.decisions).length >= 1, {
+    message: 'decisions must declare at least one decision',
+});

package/dist/types.d.ts

@@ -0,0 +1,84 @@
+import type { Desc, Json } from '@gobing-ai/ts-ai-runner';
+/** Jev question types a decision can declare (task 0089 R4). */
+export type DecisionType = 'choice' | 'score' | 'noul';
+/** Declared parameter types; `enum` requires `values`, `json` accepts any JSON value. */
+export type ParamType = 'string' | 'number' | 'boolean' | 'enum' | 'json';
+/** One declared parameter, normalized from the shorthand (`name: type`) or full form. */
+export interface DecisionParam {
+    readonly name: string;
+    readonly type: ParamType;
+    /** True when authored without a `default` key: every call must supply it. */
+    readonly required: boolean;
+    /** Authored `default` value (may be null); defined exactly when not required. */
+    readonly default?: Json;
+    /** Accepted strings for `type: enum` (at least one). */
+    readonly values?: readonly string[];
+    readonly description?: string;
+}
+/** A criteria/instructions entry: description string, JSON object, JSON array, or null ("undescribed"). */
+export type JevEntry = Desc;
+/** Normalized criteria of a decision, shaped by its `type`. */
+export type DecisionCriteria = {
+    readonly kind: 'choice';
+    readonly labels: Readonly<Record<string, JevEntry>>;
+} | {
+    readonly kind: 'score';
+    readonly levels: readonly JevEntry[];
+} | {
+    readonly kind: 'noul';
+    readonly outcomes?: {
+        readonly true?: JevEntry;
+        readonly false?: JevEntry;
+    };
+};
+/** One typed decision definition as produced by the loader. */
+export interface DecisionDefinition {
+    readonly id: string;
+    readonly source: string;
+    readonly type: DecisionType;
+    /** Documentation only; never sent to the model. */
+    readonly description?: string;
+    /** Authored instructions template; {@link DEFAULT_INSTRUCTIONS_TEMPLATE} when absent. */
+    readonly instructions: JevEntry;
+    /** Declared parameters plus the implicit reserved `instructions` parameter. */
+    readonly parameters: Readonly<Record<string, DecisionParam>>;
+    readonly criteria: DecisionCriteria;
+    readonly fallback: string | number | boolean;
+    /** Overrides `defaults.minConfidence` (0..1). */
+    readonly minConfidence?: number;
+    /** Registry name, checked at hub load, not by the catalog loader. */
+    readonly maker?: string;
+    readonly model?: string;
+}
+/** Catalog-wide maker/model/minConfidence defaults; every key optional. */
+export interface CatalogDefaults {
+    readonly maker?: string;
+    readonly model?: string;
+    readonly minConfidence?: number;
+}
+/** A loaded catalog: typed definitions, all-or-nothing (task 0089 invariant). */
+export interface DecisionCatalog {
+    readonly source: string;
+    readonly defaults: CatalogDefaults;
+    readonly decisions: Readonly<Record<string, DecisionDefinition>>;
+}
+/** Fully resolved parameter values for one `decide` call, including `instructions`. */
+export type ResolvedParams = Record<string, Json>;
+/** The rendered Jev question for one decision, ready for the neutral surface. */
+export type JevQuestion = {
+    readonly type: 'choice';
+    readonly instructions: JevEntry;
+    readonly criteria: Readonly<Record<string, JevEntry>>;
+} | {
+    readonly type: 'score';
+    readonly instructions: JevEntry;
+    readonly criteria: readonly JevEntry[];
+} | {
+    readonly type: 'noul';
+    readonly instructions: JevEntry;
+    readonly criteria?: {
+        readonly true?: JevEntry;
+        readonly false?: JevEntry;
+    };
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/examples/decisions.yaml

@@ -0,0 +1,42 @@
+# yaml-language-server: $schema=../schemas/decision-catalog.schema.json
+$schema: "@gobing-ai/ts-ai-decision/schemas/decision-catalog.schema.json"
+version: 1
+defaults:                       # optional; every key optional
+  maker: typesafe               # a registered maker name (built-ins: typesafe | fm-local | laya-local)
+  model: jev-latest             # forwarded as the ask-level model; omit for the backend default
+  minConfidence: 0.7            # 0..1; package default 0.7 when absent everywhere
+
+decisions:
+  category:
+    type: choice
+    description: Route an inbound support ticket   # documentation only; never sent to the model
+    instructions: "Classify this ${params.channel} ticket: ${params.instructions}"
+    parameters:
+      channel: { type: enum, values: [email, chat], default: email }
+    criteria:                   # label -> description (null = undescribed); >= 2 labels
+      bug_report: The user is reporting something that is broken or producing errors
+      billing: Charges, invoices, refunds, subscriptions
+      feature_request: The user is requesting new functionality
+      account: Login, permissions, profile, security
+    fallback: account           # must be a criteria label
+
+  bug_severity:
+    type: score
+    parameters:
+      component: string         # shorthand: type only -> required
+      affected_users: { type: number, default: 10 }
+    # no `instructions` key -> defaults to "${params.instructions}"
+    criteria:                   # ordered rubric, index = level; >= 2 entries
+      - Cosmetic; no impact to functionality
+      - Broken or degraded feature in ${params.component}; workaround exists
+      - Blocking issue; no workaround exists
+    fallback: 1                 # integer level in [0, criteria.length - 1]
+    maker: laya-local           # per-decision override
+
+  refund_requested:
+    type: noul
+    criteria:                   # optional; Jev keys
+      true: The customer explicitly asks for money back
+      false: Anything else
+    fallback: false             # boolean
+    minConfidence: 0.8

package/examples/support.yaml

@@ -0,0 +1,54 @@
+# yaml-language-server: $schema=../schemas/decision-catalog.schema.json
+$schema: "@gobing-ai/ts-ai-decision/schemas/decision-catalog.schema.json"
+version: 1
+defaults:
+  maker: typesafe        # a registered maker name (built-ins: typesafe | fm-local | laya-local)
+  model: jev-latest      # forwarded as the ask-level model; omit for the backend default
+  minConfidence: 0.7
+
+decisions:
+  category:
+    type: choice
+    description: Route an inbound support ticket
+    instructions: "Classify this ${params.channel} ticket: ${params.instructions}"
+    parameters:
+      channel: { type: enum, values: [email, chat], default: email }
+    criteria:                   # label -> description; >= 2 labels
+      bug_report: The user is reporting something that is broken or producing errors
+      billing: Charges, invoices, refunds, subscriptions
+      feature_request: The user is requesting new functionality
+      account: Login, permissions, profile, security
+    fallback: account           # must be a criteria label
+
+  bug_severity:
+    type: score
+    parameters:
+      component: string         # shorthand: type only -> required
+      affected_users: { type: number, default: 10 }
+    # no `instructions` key -> defaults to "${params.instructions}"
+    criteria:                   # ordered rubric, index = level; >= 2 entries
+      - Cosmetic; no impact to functionality
+      - "Broken or degraded feature in ${params.component}; workaround exists"
+      - Blocking issue; no workaround exists
+    fallback: 1                 # integer level in [0, criteria.length - 1]
+    maker: laya-local           # per-decision override
+
+  refund_requested:
+    type: noul
+    criteria:                   # optional; Jev keys
+      true: The customer explicitly asks for money back
+      false: Anything else
+    fallback: false             # boolean
+    minConfidence: 0.8
+
+  send_reply:
+    type: choice
+    description: Draft or drop an automated reply
+    instructions: "Reply in a ${params.tone} tone. Context: ${params.context}"
+    parameters:
+      tone: { type: enum, values: [formal, casual], default: casual }
+      context: { type: json, default: null }   # optional; substitutes as "" when null
+    criteria:
+      send: Draft a reply for review
+      discard: Do not reply
+    fallback: discard

package/package.json

@@ -0,0 +1,66 @@
+{
+    "name": "@gobing-ai/ts-ai-decision",
+    "version": "0.5.13",
+    "description": "@gobing-ai/ts-ai-decision — Declarative YAML decision catalog over the ts-ai-runner DecisionMaker surface.",
+    "keywords": [
+        "typescript",
+        "ai",
+        "decision",
+        "catalog",
+        "llm"
+    ],
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/gobing-ai/ts-libs.git",
+        "directory": "packages/ai-decision"
+    },
+    "author": "Robin Min <minlongbing@gmail.com>",
+    "contributors": [
+        "Robin Min <minlongbing@gmail.com>"
+    ],
+    "type": "module",
+    "private": false,
+    "sideEffects": false,
+    "license": "Apache-2.0",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js"
+        },
+        "./schemas/*": "./schemas/*",
+        "./package.json": "./package.json"
+    },
+    "files": [
+        "dist",
+        "src",
+        "schemas",
+        "examples",
+        "README.md"
+    ],
+    "scripts": {
+        "build": "tsc -p tsconfig.build.json && bun ../../scripts/builder.ts fix-dist-esm-extensions dist",
+        "test": "NODE_ENV=test bun test --coverage --coverage-dir=.coverage --reporter=dots",
+        "test:full": "NODE_ENV=test bun test --update-snapshots --coverage --coverage-dir=.coverage",
+        "typecheck": "tsc --noEmit",
+        "lint": "biome check . && bun run typecheck",
+        "format": "biome check . --write",
+        "check": "bun run lint && bun run test",
+        "prepublishOnly": "bun ../../scripts/builder.ts check-publish-manifest . && bun run build",
+        "release": "echo 'Manual publish is disabled. Releases go through GitHub Actions via Trusted Publishing — push a tag: git tag @gobing-ai/ts-ai-decision-v<version> && git push --tags' && exit 1"
+    },
+    "dependencies": {
+        "@gobing-ai/ts-ai-runner": "^0.5.13",
+        "@gobing-ai/ts-decision-fm": "^0.5.13",
+        "@gobing-ai/ts-laya-mlx": "^0.5.13",
+        "@gobing-ai/ts-runtime": "^0.5.13",
+        "zod": "^4.1.0"
+    },
+    "devDependencies": {
+        "@types/bun": "1.3.14"
+    },
+    "publishConfig": {
+        "access": "public"
+    }
+}