@livx.cc/agentx 0.99.12 → 0.99.14

package/dist/models.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Model aliasing + mid-conversation switch resolution — pure, dependency-free.
+ *
+ * Harness-level so every agentx consumer (unclaw, para-chat, …) resolves `[opus]`-style
+ * aliases, gates by an allow-list, and announces a switch the same way. Policy (which models
+ * a caller may use) and session state (the prior model) stay with the consumer; this module
+ * is the shared mechanism.
+ */
+/** Canonical short aliases → concrete Anthropic model ids. */
+declare const MODEL_ALIASES: Record<string, string>;
+/** Resolve an alias to a concrete id. A provider prefix ("anthropic/") is preserved; unknown ids pass through. */
+declare function resolveModelAlias(input: string): string;
+/** Short, human-friendly name for a resolved model id (e.g. "anthropic/claude-opus-4-8" → "opus"). */
+declare function modelShortLabel(model?: string): string;
+interface ResolveModelSwitchOpts {
+    /** Model requested for this turn (e.g. from an inline directive). Undefined = keep `current`. */
+    requested?: string;
+    /** The turn's default/current model when nothing is requested. */
+    current: string;
+    /** The session's prior resolved model — drives change detection + the notice. */
+    prior?: string;
+    /** If set, `requested` must match one of these (by short label) or it's denied and `current` is kept. */
+    allowed?: string[];
+    /** Announcement formatter. Default: `_[switching from x to y]_\n\n`. */
+    format?: (from: string, to: string) => string;
+}
+interface ModelSwitch {
+    /** The model to run this turn. */
+    model: string;
+    /** True when `requested` was rejected by `allowed` and `model` fell back to `current`. */
+    denied: boolean;
+    /** Inline notice to surface when the model actually changed vs `prior`, else undefined. */
+    notice?: string;
+}
+/**
+ * Resolve which model a turn runs, given an optional request, an allow-list, and the prior model.
+ * Comparisons are by short label so provider-prefixed and dated ids unify
+ * ("anthropic/claude-opus-4-8" ≡ "claude-opus-4-8" ≡ "opus").
+ */
+declare function resolveModelSwitch(opts: ResolveModelSwitchOpts): ModelSwitch;
+
+export { MODEL_ALIASES, type ModelSwitch, type ResolveModelSwitchOpts, modelShortLabel, resolveModelAlias, resolveModelSwitch };

package/dist/models.js

@@ -0,0 +1,45 @@
+// src/models.ts
+var MODEL_ALIASES = {
+  fable: "claude-fable-5",
+  "fable-5": "claude-fable-5",
+  opus: "claude-opus-4-8",
+  "opus-4-8": "claude-opus-4-8",
+  "opus-4-7": "claude-opus-4-7",
+  "opus-4-6": "claude-opus-4-6",
+  sonnet: "claude-sonnet-4-6",
+  haiku: "claude-haiku-4-5-20251001"
+};
+function resolveModelAlias(input) {
+  const slash = input.indexOf("/");
+  const prefix = slash === -1 ? "" : input.slice(0, slash + 1);
+  const rest = slash === -1 ? input : input.slice(slash + 1);
+  return prefix + (MODEL_ALIASES[rest.toLowerCase()] ?? rest);
+}
+function modelShortLabel(model) {
+  if (!model) return "default";
+  const id = model.split("/").pop();
+  return id.replace(/^claude-/, "").replace(/-\d.*$/, "");
+}
+function resolveModelSwitch(opts) {
+  const { requested, current, prior, allowed } = opts;
+  if (!requested) return { model: current, denied: false };
+  if (allowed && !allowed.some((a) => modelShortLabel(a) === modelShortLabel(requested))) {
+    return { model: current, denied: true };
+  }
+  const fmt = opts.format ?? ((from, to) => `_[switching from ${from} to ${to}]_
+
+`);
+  const changed = prior !== void 0 && modelShortLabel(prior) !== modelShortLabel(requested);
+  return {
+    model: requested,
+    denied: false,
+    notice: changed ? fmt(modelShortLabel(prior), modelShortLabel(requested)) : void 0
+  };
+}
+export {
+  MODEL_ALIASES,
+  modelShortLabel,
+  resolveModelAlias,
+  resolveModelSwitch
+};
+//# sourceMappingURL=models.js.map

package/dist/models.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/models.ts"],"sourcesContent":["/**\n * Model aliasing + mid-conversation switch resolution — pure, dependency-free.\n *\n * Harness-level so every agentx consumer (unclaw, para-chat, …) resolves `[opus]`-style\n * aliases, gates by an allow-list, and announces a switch the same way. Policy (which models\n * a caller may use) and session state (the prior model) stay with the consumer; this module\n * is the shared mechanism.\n */\n\n/** Canonical short aliases → concrete Anthropic model ids. */\nexport const MODEL_ALIASES: Record<string, string> = {\n  fable: 'claude-fable-5',\n  'fable-5': 'claude-fable-5',\n  opus: 'claude-opus-4-8',\n  'opus-4-8': 'claude-opus-4-8',\n  'opus-4-7': 'claude-opus-4-7',\n  'opus-4-6': 'claude-opus-4-6',\n  sonnet: 'claude-sonnet-4-6',\n  haiku: 'claude-haiku-4-5-20251001',\n};\n\n/** Resolve an alias to a concrete id. A provider prefix (\"anthropic/\") is preserved; unknown ids pass through. */\nexport function resolveModelAlias(input: string): string {\n  const slash = input.indexOf('/');\n  const prefix = slash === -1 ? '' : input.slice(0, slash + 1);\n  const rest = slash === -1 ? input : input.slice(slash + 1);\n  return prefix + (MODEL_ALIASES[rest.toLowerCase()] ?? rest);\n}\n\n/** Short, human-friendly name for a resolved model id (e.g. \"anthropic/claude-opus-4-8\" → \"opus\"). */\nexport function modelShortLabel(model?: string): string {\n  if (!model) return 'default';\n  const id = model.split('/').pop()!;\n  return id.replace(/^claude-/, '').replace(/-\\d.*$/, '');\n}\n\nexport interface ResolveModelSwitchOpts {\n  /** Model requested for this turn (e.g. from an inline directive). Undefined = keep `current`. */\n  requested?: string;\n  /** The turn's default/current model when nothing is requested. */\n  current: string;\n  /** The session's prior resolved model — drives change detection + the notice. */\n  prior?: string;\n  /** If set, `requested` must match one of these (by short label) or it's denied and `current` is kept. */\n  allowed?: string[];\n  /** Announcement formatter. Default: `_[switching from x to y]_\\n\\n`. */\n  format?: (from: string, to: string) => string;\n}\n\nexport interface ModelSwitch {\n  /** The model to run this turn. */\n  model: string;\n  /** True when `requested` was rejected by `allowed` and `model` fell back to `current`. */\n  denied: boolean;\n  /** Inline notice to surface when the model actually changed vs `prior`, else undefined. */\n  notice?: string;\n}\n\n/**\n * Resolve which model a turn runs, given an optional request, an allow-list, and the prior model.\n * Comparisons are by short label so provider-prefixed and dated ids unify\n * (\"anthropic/claude-opus-4-8\" ≡ \"claude-opus-4-8\" ≡ \"opus\").\n */\nexport function resolveModelSwitch(opts: ResolveModelSwitchOpts): ModelSwitch {\n  const { requested, current, prior, allowed } = opts;\n  if (!requested) return { model: current, denied: false };\n  if (allowed && !allowed.some((a) => modelShortLabel(a) === modelShortLabel(requested))) {\n    return { model: current, denied: true };\n  }\n  const fmt = opts.format ?? ((from: string, to: string) => `_[switching from ${from} to ${to}]_\\n\\n`);\n  const changed = prior !== undefined && modelShortLabel(prior) !== modelShortLabel(requested);\n  return {\n    model: requested,\n    denied: false,\n    notice: changed ? fmt(modelShortLabel(prior!), modelShortLabel(requested)) : undefined,\n  };\n}\n"],"mappings":";AAUO,IAAM,gBAAwC;AAAA,EACnD,OAAO;AAAA,EACP,WAAW;AAAA,EACX,MAAM;AAAA,EACN,YAAY;AAAA,EACZ,YAAY;AAAA,EACZ,YAAY;AAAA,EACZ,QAAQ;AAAA,EACR,OAAO;AACT;AAGO,SAAS,kBAAkB,OAAuB;AACvD,QAAM,QAAQ,MAAM,QAAQ,GAAG;AAC/B,QAAM,SAAS,UAAU,KAAK,KAAK,MAAM,MAAM,GAAG,QAAQ,CAAC;AAC3D,QAAM,OAAO,UAAU,KAAK,QAAQ,MAAM,MAAM,QAAQ,CAAC;AACzD,SAAO,UAAU,cAAc,KAAK,YAAY,CAAC,KAAK;AACxD;AAGO,SAAS,gBAAgB,OAAwB;AACtD,MAAI,CAAC,MAAO,QAAO;AACnB,QAAM,KAAK,MAAM,MAAM,GAAG,EAAE,IAAI;AAChC,SAAO,GAAG,QAAQ,YAAY,EAAE,EAAE,QAAQ,UAAU,EAAE;AACxD;AA6BO,SAAS,mBAAmB,MAA2C;AAC5E,QAAM,EAAE,WAAW,SAAS,OAAO,QAAQ,IAAI;AAC/C,MAAI,CAAC,UAAW,QAAO,EAAE,OAAO,SAAS,QAAQ,MAAM;AACvD,MAAI,WAAW,CAAC,QAAQ,KAAK,CAAC,MAAM,gBAAgB,CAAC,MAAM,gBAAgB,SAAS,CAAC,GAAG;AACtF,WAAO,EAAE,OAAO,SAAS,QAAQ,KAAK;AAAA,EACxC;AACA,QAAM,MAAM,KAAK,WAAW,CAAC,MAAc,OAAe,oBAAoB,IAAI,OAAO,EAAE;AAAA;AAAA;AAC3F,QAAM,UAAU,UAAU,UAAa,gBAAgB,KAAK,MAAM,gBAAgB,SAAS;AAC3F,SAAO;AAAA,IACL,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,QAAQ,UAAU,IAAI,gBAAgB,KAAM,GAAG,gBAAgB,SAAS,CAAC,IAAI;AAAA,EAC/E;AACF;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@livx.cc/agentx",
-  "version": "0.99.12",
+  "version": "0.99.14",
   "description": "Edge-native AI agent runtime — drives a virtual filesystem via any LLM (ai.libx.js). Same bytes run in node, browser, or edge.",
   "type": "module",
   "main": "./dist/index.js",
@@ -18,6 +18,10 @@
     "./tools.shell": {
       "types": "./dist/tools.shell.d.ts",
       "default": "./dist/tools.shell.js"
+    },
+    "./models": {
+      "types": "./dist/models.d.ts",
+      "default": "./dist/models.js"
     }
   },
   "license": "MIT",