@elizaos/plugin-training 2.0.3-beta.5 → 2.0.3-beta.7

package/dist/dspy/optimizers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/dspy/optimizers/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,MAAM,iBAAiB,GACzB,wBAAwB,GACxB,YAAY,GACZ,YAAY,CAAC;AAEjB;;;GAGG;AACH,MAAM,MAAM,MAAM,GAAG,CACnB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,MAAM,CAAC;AAEZ,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,iBAAiB,CAAC;IAC7B,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,OAAO,EAAE,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,qBAAqB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,EAAE,EAAE,oBAAoB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC"}

package/dist/dspy/optimizers/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/dspy/optimizers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/dspy/predict.d.ts

@@ -0,0 +1,49 @@
+/**
+ * DSPy-style Predict module (native TS).
+ *
+ * Predict is the smallest composable LM module:
+ *   1. Render a Signature into a system + user prompt.
+ *   2. Prepend few-shot demonstrations (if any).
+ *   3. Call the LM adapter.
+ *   4. Parse the LM's response into typed output fields.
+ *
+ * `Predict.forward()` returns `{output, usage, trace}` so optimizer code can
+ * inspect what was sent + what came back without re-running the LM.
+ */
+import type { Example } from "./examples.js";
+import type { LanguageModelAdapter, UsageInfo } from "./lm-adapter.js";
+import type { Signature, SignatureSpec } from "./signature.js";
+export interface PredictOpts<I extends Record<string, unknown> = Record<string, unknown>, O extends Record<string, unknown> = Record<string, unknown>> {
+    signature: Signature<I, O>;
+    lm: LanguageModelAdapter;
+    demonstrations?: Example[];
+    temperature?: number;
+    maxTokens?: number;
+    /** Override instructions without rebuilding the signature (used by COPRO). */
+    instructionsOverride?: string;
+}
+export interface PredictTrace {
+    system: string;
+    user: string;
+    rawResponse: string;
+    demonstrationCount: number;
+}
+export interface PredictResult<O extends Record<string, unknown> = Record<string, unknown>> {
+    output: O;
+    usage: UsageInfo;
+    trace: PredictTrace;
+}
+export declare class Predict<I extends Record<string, unknown> = Record<string, unknown>, O extends Record<string, unknown> = Record<string, unknown>> {
+    private readonly opts;
+    constructor(opts: PredictOpts<I, O>);
+    get signature(): Signature<I, O>;
+    get demonstrations(): Example[];
+    forward(input: I): Promise<PredictResult<O>>;
+}
+/**
+ * Render a `Demonstrations:` block in the same shape the signature uses for
+ * a real turn. Used by both Predict and the bootstrap-fewshot optimizer so
+ * the few-shot format is one canonical thing.
+ */
+export declare function renderDemonstrationsBlock(spec: SignatureSpec, demos: Example[]): string;
+//# sourceMappingURL=predict.d.ts.map

package/dist/dspy/predict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"predict.d.ts","sourceRoot":"","sources":["../../src/dspy/predict.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAEV,oBAAoB,EACpB,SAAS,EACV,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/D,MAAM,WAAW,WAAW,CAC1B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3D,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAE3D,SAAS,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3B,EAAE,EAAE,oBAAoB,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,EAAE,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa,CAC5B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAE3D,MAAM,EAAE,CAAC,CAAC;IACV,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,qBAAa,OAAO,CAClB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3D,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAE/C,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC;IAEpD,IAAI,SAAS,IAAI,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAE/B;IAED,IAAI,cAAc,IAAI,OAAO,EAAE,CAE9B;IAEK,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;CAiCnD;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,OAAO,EAAE,GACf,MAAM,CAoBR"}

package/dist/dspy/predict.js

@@ -0,0 +1,73 @@
+class Predict {
+  constructor(opts) {
+    this.opts = opts;
+  }
+  opts;
+  get signature() {
+    return this.opts.signature;
+  }
+  get demonstrations() {
+    return this.opts.demonstrations ?? [];
+  }
+  async forward(input) {
+    const rendered = this.opts.signature.render(input, {
+      instructionsOverride: this.opts.instructionsOverride
+    });
+    const demoBlock = renderDemonstrationsBlock(
+      this.opts.signature.spec,
+      this.opts.demonstrations ?? []
+    );
+    const system = demoBlock ? `${rendered.system}
+
+${demoBlock}` : rendered.system;
+    const result = await this.opts.lm.generate({
+      system,
+      messages: [{ role: "user", content: rendered.user }],
+      temperature: this.opts.temperature ?? 0,
+      maxTokens: this.opts.maxTokens
+    });
+    const output = this.opts.signature.parse(result.text);
+    return {
+      output,
+      usage: result.usage,
+      trace: {
+        system,
+        user: rendered.user,
+        rawResponse: result.text,
+        demonstrationCount: this.opts.demonstrations?.length ?? 0
+      }
+    };
+  }
+}
+function renderDemonstrationsBlock(spec, demos) {
+  if (demos.length === 0) return "";
+  const lines = ["Demonstrations:", ""];
+  for (let i = 0; i < demos.length; i += 1) {
+    const demo = demos[i];
+    if (!demo) continue;
+    lines.push(`Example ${i + 1}:`);
+    for (const field of spec.inputs) {
+      const value = demo.inputs[field.name];
+      if (value === void 0 || value === null) continue;
+      lines.push(`${field.name}: ${renderForDemo(value)}`);
+    }
+    for (const field of spec.outputs) {
+      const value = demo.outputs[field.name];
+      if (value === void 0 || value === null) continue;
+      lines.push(`${field.name}: ${renderForDemo(value)}`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n").trimEnd();
+}
+function renderForDemo(value) {
+  if (typeof value === "string") return value;
+  if (typeof value === "number" || typeof value === "boolean")
+    return String(value);
+  return JSON.stringify(value);
+}
+export {
+  Predict,
+  renderDemonstrationsBlock
+};
+//# sourceMappingURL=predict.js.map

package/dist/dspy/predict.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/dspy/predict.ts"],"sourcesContent":["/**\n * DSPy-style Predict module (native TS).\n *\n * Predict is the smallest composable LM module:\n *   1. Render a Signature into a system + user prompt.\n *   2. Prepend few-shot demonstrations (if any).\n *   3. Call the LM adapter.\n *   4. Parse the LM's response into typed output fields.\n *\n * `Predict.forward()` returns `{output, usage, trace}` so optimizer code can\n * inspect what was sent + what came back without re-running the LM.\n */\n\nimport type { Example } from \"./examples.js\";\nimport type {\n  GenerateResult,\n  LanguageModelAdapter,\n  UsageInfo,\n} from \"./lm-adapter.js\";\nimport type { Signature, SignatureSpec } from \"./signature.js\";\n\nexport interface PredictOpts<\n  I extends Record<string, unknown> = Record<string, unknown>,\n  O extends Record<string, unknown> = Record<string, unknown>,\n> {\n  signature: Signature<I, O>;\n  lm: LanguageModelAdapter;\n  demonstrations?: Example[];\n  temperature?: number;\n  maxTokens?: number;\n  /** Override instructions without rebuilding the signature (used by COPRO). */\n  instructionsOverride?: string;\n}\n\nexport interface PredictTrace {\n  system: string;\n  user: string;\n  rawResponse: string;\n  demonstrationCount: number;\n}\n\nexport interface PredictResult<\n  O extends Record<string, unknown> = Record<string, unknown>,\n> {\n  output: O;\n  usage: UsageInfo;\n  trace: PredictTrace;\n}\n\nexport class Predict<\n  I extends Record<string, unknown> = Record<string, unknown>,\n  O extends Record<string, unknown> = Record<string, unknown>,\n> {\n  constructor(private readonly opts: PredictOpts<I, O>) {}\n\n  get signature(): Signature<I, O> {\n    return this.opts.signature;\n  }\n\n  get demonstrations(): Example[] {\n    return this.opts.demonstrations ?? [];\n  }\n\n  async forward(input: I): Promise<PredictResult<O>> {\n    const rendered = this.opts.signature.render(input, {\n      instructionsOverride: this.opts.instructionsOverride,\n    });\n    const demoBlock = renderDemonstrationsBlock(\n      this.opts.signature.spec,\n      this.opts.demonstrations ?? [],\n    );\n    const system = demoBlock\n      ? `${rendered.system}\\n\\n${demoBlock}`\n      : rendered.system;\n    const result: GenerateResult = await this.opts.lm.generate({\n      system,\n      messages: [{ role: \"user\", content: rendered.user }],\n      temperature: this.opts.temperature ?? 0,\n      maxTokens: this.opts.maxTokens,\n    });\n    // `signature.parse` is the LM-response boundary: it throws\n    // `SignatureParseError` on malformed output. No silent fallback — the\n    // optimizer scoring loop catches the throw and scores 0 (documented\n    // behavior in `dspy-bootstrap-fewshot.ts` / `dspy-copro.ts` / `dspy-mipro.ts`).\n    const output = this.opts.signature.parse(result.text);\n    return {\n      output,\n      usage: result.usage,\n      trace: {\n        system,\n        user: rendered.user,\n        rawResponse: result.text,\n        demonstrationCount: this.opts.demonstrations?.length ?? 0,\n      },\n    };\n  }\n}\n\n/**\n * Render a `Demonstrations:` block in the same shape the signature uses for\n * a real turn. Used by both Predict and the bootstrap-fewshot optimizer so\n * the few-shot format is one canonical thing.\n */\nexport function renderDemonstrationsBlock(\n  spec: SignatureSpec,\n  demos: Example[],\n): string {\n  if (demos.length === 0) return \"\";\n  const lines: string[] = [\"Demonstrations:\", \"\"];\n  for (let i = 0; i < demos.length; i += 1) {\n    const demo = demos[i];\n    if (!demo) continue;\n    lines.push(`Example ${i + 1}:`);\n    for (const field of spec.inputs) {\n      const value = demo.inputs[field.name];\n      if (value === undefined || value === null) continue;\n      lines.push(`${field.name}: ${renderForDemo(value)}`);\n    }\n    for (const field of spec.outputs) {\n      const value = demo.outputs[field.name];\n      if (value === undefined || value === null) continue;\n      lines.push(`${field.name}: ${renderForDemo(value)}`);\n    }\n    lines.push(\"\");\n  }\n  return lines.join(\"\\n\").trimEnd();\n}\n\nfunction renderForDemo(value: unknown): string {\n  if (typeof value === \"string\") return value;\n  if (typeof value === \"number\" || typeof value === \"boolean\")\n    return String(value);\n  return JSON.stringify(value);\n}\n"],"mappings":"AAiDO,MAAM,QAGX;AAAA,EACA,YAA6B,MAAyB;AAAzB;AAAA,EAA0B;AAAA,EAA1B;AAAA,EAE7B,IAAI,YAA6B;AAC/B,WAAO,KAAK,KAAK;AAAA,EACnB;AAAA,EAEA,IAAI,iBAA4B;AAC9B,WAAO,KAAK,KAAK,kBAAkB,CAAC;AAAA,EACtC;AAAA,EAEA,MAAM,QAAQ,OAAqC;AACjD,UAAM,WAAW,KAAK,KAAK,UAAU,OAAO,OAAO;AAAA,MACjD,sBAAsB,KAAK,KAAK;AAAA,IAClC,CAAC;AACD,UAAM,YAAY;AAAA,MAChB,KAAK,KAAK,UAAU;AAAA,MACpB,KAAK,KAAK,kBAAkB,CAAC;AAAA,IAC/B;AACA,UAAM,SAAS,YACX,GAAG,SAAS,MAAM;AAAA;AAAA,EAAO,SAAS,KAClC,SAAS;AACb,UAAM,SAAyB,MAAM,KAAK,KAAK,GAAG,SAAS;AAAA,MACzD;AAAA,MACA,UAAU,CAAC,EAAE,MAAM,QAAQ,SAAS,SAAS,KAAK,CAAC;AAAA,MACnD,aAAa,KAAK,KAAK,eAAe;AAAA,MACtC,WAAW,KAAK,KAAK;AAAA,IACvB,CAAC;AAKD,UAAM,SAAS,KAAK,KAAK,UAAU,MAAM,OAAO,IAAI;AACpD,WAAO;AAAA,MACL;AAAA,MACA,OAAO,OAAO;AAAA,MACd,OAAO;AAAA,QACL;AAAA,QACA,MAAM,SAAS;AAAA,QACf,aAAa,OAAO;AAAA,QACpB,oBAAoB,KAAK,KAAK,gBAAgB,UAAU;AAAA,MAC1D;AAAA,IACF;AAAA,EACF;AACF;AAOO,SAAS,0BACd,MACA,OACQ;AACR,MAAI,MAAM,WAAW,EAAG,QAAO;AAC/B,QAAM,QAAkB,CAAC,mBAAmB,EAAE;AAC9C,WAAS,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK,GAAG;AACxC,UAAM,OAAO,MAAM,CAAC;AACpB,QAAI,CAAC,KAAM;AACX,UAAM,KAAK,WAAW,IAAI,CAAC,GAAG;AAC9B,eAAW,SAAS,KAAK,QAAQ;AAC/B,YAAM,QAAQ,KAAK,OAAO,MAAM,IAAI;AACpC,UAAI,UAAU,UAAa,UAAU,KAAM;AAC3C,YAAM,KAAK,GAAG,MAAM,IAAI,KAAK,cAAc,KAAK,CAAC,EAAE;AAAA,IACrD;AACA,eAAW,SAAS,KAAK,SAAS;AAChC,YAAM,QAAQ,KAAK,QAAQ,MAAM,IAAI;AACrC,UAAI,UAAU,UAAa,UAAU,KAAM;AAC3C,YAAM,KAAK,GAAG,MAAM,IAAI,KAAK,cAAc,KAAK,CAAC,EAAE;AAAA,IACrD;AACA,UAAM,KAAK,EAAE;AAAA,EACf;AACA,SAAO,MAAM,KAAK,IAAI,EAAE,QAAQ;AAClC;AAEA,SAAS,cAAc,OAAwB;AAC7C,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,MAAI,OAAO,UAAU,YAAY,OAAO,UAAU;AAChD,WAAO,OAAO,KAAK;AACrB,SAAO,KAAK,UAAU,KAAK;AAC7B;","names":[]}

package/dist/dspy/signature.d.ts

@@ -0,0 +1,88 @@
+/**
+ * DSPy-style Signature primitive (native TS).
+ *
+ * A `Signature` is a declarative I/O contract between a Predict module and an
+ * LM: typed input fields + typed output fields + natural-language instructions.
+ * The runtime renders a Signature into a system + user prompt and parses the
+ * LM's response back into a typed output record.
+ *
+ * This is our own implementation — no ax, no dspy, no @ax-llm/ax imports.
+ *
+ * Render protocol (deterministic so optimizer scoring is reproducible):
+ *
+ *   System prompt:
+ *     <instructions>
+ *
+ *     Input fields:
+ *     - <name> (<type>): <description>
+ *     ...
+ *
+ *     Output fields:
+ *     - <name> (<type>): <description>
+ *     ...
+ *
+ *     Respond with each output field on its own line, formatted as:
+ *     <field_name>: <value>
+ *
+ *   User prompt:
+ *     <input_name>: <value>
+ *     ...
+ *
+ * Parse protocol: read `^<field_name>:\s*(.*)$` per line. Multiline trailing
+ * content is captured up to the next field-name header so output fields with
+ * multi-line `reasoning` strings round-trip correctly.
+ */
+export type FieldType = "string" | "number" | "boolean" | "enum";
+export interface FieldSpec {
+    name: string;
+    description: string;
+    type: FieldType;
+    enumValues?: readonly string[];
+    optional?: boolean;
+}
+export interface SignatureSpec {
+    name: string;
+    instructions: string;
+    inputs: ReadonlyArray<FieldSpec>;
+    outputs: ReadonlyArray<FieldSpec>;
+}
+export interface RenderedPrompt {
+    system: string;
+    user: string;
+}
+export declare class SignatureParseError extends Error {
+    readonly fieldName?: string | undefined;
+    constructor(message: string, fieldName?: string | undefined);
+}
+/**
+ * Strongly-typed Signature handle.
+ *
+ * The generic parameters carry the field-name keys so callers get
+ * autocomplete on `forward()` inputs and on the parsed `output` record.
+ */
+export declare class Signature<I extends Record<string, unknown> = Record<string, unknown>, O extends Record<string, unknown> = Record<string, unknown>> {
+    readonly spec: SignatureSpec;
+    constructor(spec: SignatureSpec);
+    get name(): string;
+    get inputs(): ReadonlyArray<FieldSpec>;
+    get outputs(): ReadonlyArray<FieldSpec>;
+    /**
+     * Render the signature to a system + user prompt. The `instructionsOverride`
+     * lets COPRO/MIPRO swap in a candidate instruction string without rebuilding
+     * the whole signature.
+     */
+    render(input: I, options?: {
+        instructionsOverride?: string;
+    }): RenderedPrompt;
+    /**
+     * Parse an LM response into a typed output record. Multi-line field values
+     * are supported — content after `<field>:` extends until the next known
+     * field header or end of string.
+     */
+    parse(raw: string): O;
+}
+/**
+ * Convenience constructor for signatures defined as a literal block.
+ */
+export declare function defineSignature<I extends Record<string, unknown> = Record<string, unknown>, O extends Record<string, unknown> = Record<string, unknown>>(spec: SignatureSpec): Signature<I, O>;
+//# sourceMappingURL=signature.d.ts.map

package/dist/dspy/signature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature.d.ts","sourceRoot":"","sources":["../../src/dspy/signature.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAEjE,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACjC,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAG1C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM;gBAD3B,OAAO,EAAE,MAAM,EACN,SAAS,CAAC,EAAE,MAAM,YAAA;CAK9B;AAED;;;;;GAKG;AACH,qBAAa,SAAS,CACpB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3D,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;aAE/B,IAAI,EAAE,aAAa;gBAAnB,IAAI,EAAE,aAAa;IAwB/C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,MAAM,IAAI,aAAa,CAAC,SAAS,CAAC,CAErC;IAED,IAAI,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,CAEtC;IAED;;;;OAIG;IACH,MAAM,CACJ,KAAK,EAAE,CAAC,EACR,OAAO,CAAC,EAAE;QAAE,oBAAoB,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1C,cAAc;IA+CjB;;;;OAIG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC;CAyBtB;AA2GD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3D,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3D,IAAI,EAAE,aAAa,GAAG,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAEtC"}

package/dist/dspy/signature.js

@@ -0,0 +1,205 @@
+class SignatureParseError extends Error {
+  constructor(message, fieldName) {
+    super(message);
+    this.fieldName = fieldName;
+    this.name = "SignatureParseError";
+  }
+  fieldName;
+}
+class Signature {
+  constructor(spec) {
+    this.spec = spec;
+    if (spec.inputs.length === 0) {
+      throw new Error(
+        `[Signature] '${spec.name}' must declare at least one input field`
+      );
+    }
+    if (spec.outputs.length === 0) {
+      throw new Error(
+        `[Signature] '${spec.name}' must declare at least one output field`
+      );
+    }
+    const names = /* @__PURE__ */ new Set();
+    for (const field of [...spec.inputs, ...spec.outputs]) {
+      if (names.has(field.name)) {
+        throw new Error(
+          `[Signature] '${spec.name}' has duplicate field name '${field.name}'`
+        );
+      }
+      names.add(field.name);
+    }
+  }
+  spec;
+  get name() {
+    return this.spec.name;
+  }
+  get inputs() {
+    return this.spec.inputs;
+  }
+  get outputs() {
+    return this.spec.outputs;
+  }
+  /**
+   * Render the signature to a system + user prompt. The `instructionsOverride`
+   * lets COPRO/MIPRO swap in a candidate instruction string without rebuilding
+   * the whole signature.
+   */
+  render(input, options) {
+    const instructions = options?.instructionsOverride ?? this.spec.instructions;
+    const systemLines = [];
+    if (instructions.trim().length > 0) {
+      systemLines.push(instructions.trim());
+      systemLines.push("");
+    }
+    systemLines.push("Input fields:");
+    for (const field of this.spec.inputs) {
+      systemLines.push(
+        `- ${field.name} (${renderFieldType(field)}): ${field.description}`
+      );
+    }
+    systemLines.push("");
+    systemLines.push("Output fields:");
+    for (const field of this.spec.outputs) {
+      systemLines.push(
+        `- ${field.name} (${renderFieldType(field)}): ${field.description}`
+      );
+    }
+    systemLines.push("");
+    systemLines.push(
+      "Respond with each output field on its own line, formatted as:"
+    );
+    systemLines.push("<field_name>: <value>");
+    const userLines = [];
+    for (const field of this.spec.inputs) {
+      const raw = input[field.name];
+      if (raw === void 0 || raw === null) {
+        if (!field.optional) {
+          throw new Error(
+            `[Signature:${this.spec.name}] missing required input '${field.name}'`
+          );
+        }
+        continue;
+      }
+      userLines.push(`${field.name}: ${renderValue(raw)}`);
+    }
+    return {
+      system: systemLines.join("\n"),
+      user: userLines.join("\n")
+    };
+  }
+  /**
+   * Parse an LM response into a typed output record. Multi-line field values
+   * are supported — content after `<field>:` extends until the next known
+   * field header or end of string.
+   */
+  parse(raw) {
+    const text = stripFences(raw);
+    const orderedFields = [...this.spec.outputs];
+    const fieldNames = orderedFields.map((f) => f.name);
+    const result = {};
+    const fieldPositions = locateFieldHeaders(text, fieldNames);
+    for (let i = 0; i < orderedFields.length; i += 1) {
+      const field = orderedFields[i];
+      if (!field) continue;
+      const span = fieldPositions[field.name];
+      if (!span) {
+        if (field.optional) continue;
+        throw new SignatureParseError(
+          `missing required output field '${field.name}' in LM response`,
+          field.name
+        );
+      }
+      const valueText = span.value;
+      result[field.name] = coerceValue(field, valueText);
+    }
+    return result;
+  }
+}
+function renderFieldType(field) {
+  if (field.type === "enum") {
+    const values = field.enumValues ?? [];
+    return `enum: ${values.join(" | ")}`;
+  }
+  return field.type;
+}
+function renderValue(value) {
+  if (typeof value === "string") return value;
+  if (typeof value === "number" || typeof value === "boolean") {
+    return String(value);
+  }
+  return JSON.stringify(value);
+}
+function stripFences(text) {
+  return text.trim().replace(/^```[a-z0-9_-]*\s*/i, "").replace(/\s*```$/i, "").trim();
+}
+function locateFieldHeaders(text, fieldNames) {
+  const positions = [];
+  for (const name of fieldNames) {
+    const escaped = name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const pattern = new RegExp(`(^|\\n)\\s*${escaped}\\s*:\\s*`, "i");
+    const match = pattern.exec(text);
+    if (!match) continue;
+    const start = match.index + (match[1] === "" ? 0 : match[1].length);
+    const valueStart = start + (match[0].length - (match[1] ?? "").length);
+    positions.push({ name, start, valueStart });
+  }
+  positions.sort((a, b) => a.start - b.start);
+  const out = {};
+  for (let i = 0; i < positions.length; i += 1) {
+    const here = positions[i];
+    if (!here) continue;
+    const next = positions[i + 1];
+    const end = next ? next.start : text.length;
+    const value = text.slice(here.valueStart, end).trimEnd();
+    out[here.name] = { value };
+  }
+  return out;
+}
+function coerceValue(field, raw) {
+  const trimmed = raw.trim();
+  switch (field.type) {
+    case "string":
+      return trimmed;
+    case "number": {
+      const num = Number(trimmed);
+      if (!Number.isFinite(num)) {
+        throw new SignatureParseError(
+          `field '${field.name}' expected number, got '${trimmed}'`,
+          field.name
+        );
+      }
+      return num;
+    }
+    case "boolean": {
+      const lower = trimmed.toLowerCase();
+      if (lower === "true" || lower === "yes" || lower === "1") return true;
+      if (lower === "false" || lower === "no" || lower === "0") return false;
+      throw new SignatureParseError(
+        `field '${field.name}' expected boolean, got '${trimmed}'`,
+        field.name
+      );
+    }
+    case "enum": {
+      const values = field.enumValues ?? [];
+      const match = values.find(
+        (v) => v.toLowerCase() === trimmed.toLowerCase()
+      );
+      if (!match) {
+        throw new SignatureParseError(
+          `field '${field.name}' expected one of [${values.join(", ")}], got '${trimmed}'`,
+          field.name
+        );
+      }
+      return match;
+    }
+  }
+}
+function defineSignature(spec) {
+  return new Signature(spec);
+}
+export {
+  Signature,
+  SignatureParseError,
+  defineSignature
+};
+//# sourceMappingURL=signature.js.map

package/dist/dspy/signature.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/dspy/signature.ts"],"sourcesContent":["/**\n * DSPy-style Signature primitive (native TS).\n *\n * A `Signature` is a declarative I/O contract between a Predict module and an\n * LM: typed input fields + typed output fields + natural-language instructions.\n * The runtime renders a Signature into a system + user prompt and parses the\n * LM's response back into a typed output record.\n *\n * This is our own implementation — no ax, no dspy, no @ax-llm/ax imports.\n *\n * Render protocol (deterministic so optimizer scoring is reproducible):\n *\n *   System prompt:\n *     <instructions>\n *\n *     Input fields:\n *     - <name> (<type>): <description>\n *     ...\n *\n *     Output fields:\n *     - <name> (<type>): <description>\n *     ...\n *\n *     Respond with each output field on its own line, formatted as:\n *     <field_name>: <value>\n *\n *   User prompt:\n *     <input_name>: <value>\n *     ...\n *\n * Parse protocol: read `^<field_name>:\\s*(.*)$` per line. Multiline trailing\n * content is captured up to the next field-name header so output fields with\n * multi-line `reasoning` strings round-trip correctly.\n */\n\nexport type FieldType = \"string\" | \"number\" | \"boolean\" | \"enum\";\n\nexport interface FieldSpec {\n  name: string;\n  description: string;\n  type: FieldType;\n  enumValues?: readonly string[];\n  optional?: boolean;\n}\n\nexport interface SignatureSpec {\n  name: string;\n  instructions: string;\n  inputs: ReadonlyArray<FieldSpec>;\n  outputs: ReadonlyArray<FieldSpec>;\n}\n\nexport interface RenderedPrompt {\n  system: string;\n  user: string;\n}\n\nexport class SignatureParseError extends Error {\n  constructor(\n    message: string,\n    readonly fieldName?: string,\n  ) {\n    super(message);\n    this.name = \"SignatureParseError\";\n  }\n}\n\n/**\n * Strongly-typed Signature handle.\n *\n * The generic parameters carry the field-name keys so callers get\n * autocomplete on `forward()` inputs and on the parsed `output` record.\n */\nexport class Signature<\n  I extends Record<string, unknown> = Record<string, unknown>,\n  O extends Record<string, unknown> = Record<string, unknown>,\n> {\n  constructor(public readonly spec: SignatureSpec) {\n    if (spec.inputs.length === 0) {\n      throw new Error(\n        `[Signature] '${spec.name}' must declare at least one input field`,\n      );\n    }\n    if (spec.outputs.length === 0) {\n      throw new Error(\n        `[Signature] '${spec.name}' must declare at least one output field`,\n      );\n    }\n    // Reject duplicate names within or across input/output sets — they would\n    // confuse the parser (output field would shadow input field).\n    const names = new Set<string>();\n    for (const field of [...spec.inputs, ...spec.outputs]) {\n      if (names.has(field.name)) {\n        throw new Error(\n          `[Signature] '${spec.name}' has duplicate field name '${field.name}'`,\n        );\n      }\n      names.add(field.name);\n    }\n  }\n\n  get name(): string {\n    return this.spec.name;\n  }\n\n  get inputs(): ReadonlyArray<FieldSpec> {\n    return this.spec.inputs;\n  }\n\n  get outputs(): ReadonlyArray<FieldSpec> {\n    return this.spec.outputs;\n  }\n\n  /**\n   * Render the signature to a system + user prompt. The `instructionsOverride`\n   * lets COPRO/MIPRO swap in a candidate instruction string without rebuilding\n   * the whole signature.\n   */\n  render(\n    input: I,\n    options?: { instructionsOverride?: string },\n  ): RenderedPrompt {\n    const instructions =\n      options?.instructionsOverride ?? this.spec.instructions;\n    const systemLines: string[] = [];\n    if (instructions.trim().length > 0) {\n      systemLines.push(instructions.trim());\n      systemLines.push(\"\");\n    }\n    systemLines.push(\"Input fields:\");\n    for (const field of this.spec.inputs) {\n      systemLines.push(\n        `- ${field.name} (${renderFieldType(field)}): ${field.description}`,\n      );\n    }\n    systemLines.push(\"\");\n    systemLines.push(\"Output fields:\");\n    for (const field of this.spec.outputs) {\n      systemLines.push(\n        `- ${field.name} (${renderFieldType(field)}): ${field.description}`,\n      );\n    }\n    systemLines.push(\"\");\n    systemLines.push(\n      \"Respond with each output field on its own line, formatted as:\",\n    );\n    systemLines.push(\"<field_name>: <value>\");\n\n    const userLines: string[] = [];\n    for (const field of this.spec.inputs) {\n      const raw = input[field.name];\n      if (raw === undefined || raw === null) {\n        if (!field.optional) {\n          throw new Error(\n            `[Signature:${this.spec.name}] missing required input '${field.name}'`,\n          );\n        }\n        continue;\n      }\n      userLines.push(`${field.name}: ${renderValue(raw)}`);\n    }\n\n    return {\n      system: systemLines.join(\"\\n\"),\n      user: userLines.join(\"\\n\"),\n    };\n  }\n\n  /**\n   * Parse an LM response into a typed output record. Multi-line field values\n   * are supported — content after `<field>:` extends until the next known\n   * field header or end of string.\n   */\n  parse(raw: string): O {\n    const text = stripFences(raw);\n    // Sort fields by name length descending so a field named `reasoning_full`\n    // is matched before `reasoning` when both exist.\n    const orderedFields = [...this.spec.outputs];\n    const fieldNames = orderedFields.map((f) => f.name);\n    const result: Record<string, unknown> = {};\n    const fieldPositions = locateFieldHeaders(text, fieldNames);\n\n    for (let i = 0; i < orderedFields.length; i += 1) {\n      const field = orderedFields[i];\n      if (!field) continue;\n      const span = fieldPositions[field.name];\n      if (!span) {\n        if (field.optional) continue;\n        throw new SignatureParseError(\n          `missing required output field '${field.name}' in LM response`,\n          field.name,\n        );\n      }\n      const valueText = span.value;\n      result[field.name] = coerceValue(field, valueText);\n    }\n    return result as O;\n  }\n}\n\nfunction renderFieldType(field: FieldSpec): string {\n  if (field.type === \"enum\") {\n    const values = field.enumValues ?? [];\n    return `enum: ${values.join(\" | \")}`;\n  }\n  return field.type;\n}\n\nfunction renderValue(value: unknown): string {\n  if (typeof value === \"string\") return value;\n  if (typeof value === \"number\" || typeof value === \"boolean\") {\n    return String(value);\n  }\n  return JSON.stringify(value);\n}\n\nfunction stripFences(text: string): string {\n  return text\n    .trim()\n    .replace(/^```[a-z0-9_-]*\\s*/i, \"\")\n    .replace(/\\s*```$/i, \"\")\n    .trim();\n}\n\ninterface FieldSpan {\n  value: string;\n}\n\n/**\n * Find each declared field header in the response text and return the\n * substring between this header and the next. Headers must appear at the\n * start of a line (anchored on `^` or `\\n`). Unknown lines before the first\n * known header are ignored — some models emit prose preamble even when told\n * not to.\n */\nfunction locateFieldHeaders(\n  text: string,\n  fieldNames: string[],\n): Record<string, FieldSpan> {\n  const positions: Array<{ name: string; start: number; valueStart: number }> =\n    [];\n  for (const name of fieldNames) {\n    // Use a fresh RegExp per field — the field header anchors on a line start.\n    const escaped = name.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n    const pattern = new RegExp(`(^|\\\\n)\\\\s*${escaped}\\\\s*:\\\\s*`, \"i\");\n    const match = pattern.exec(text);\n    if (!match) continue;\n    const start = match.index + (match[1] === \"\" ? 0 : match[1].length);\n    const valueStart = start + (match[0].length - (match[1] ?? \"\").length);\n    positions.push({ name, start, valueStart });\n  }\n  positions.sort((a, b) => a.start - b.start);\n\n  const out: Record<string, FieldSpan> = {};\n  for (let i = 0; i < positions.length; i += 1) {\n    const here = positions[i];\n    if (!here) continue;\n    const next = positions[i + 1];\n    const end = next ? next.start : text.length;\n    const value = text.slice(here.valueStart, end).trimEnd();\n    out[here.name] = { value };\n  }\n  return out;\n}\n\nfunction coerceValue(field: FieldSpec, raw: string): unknown {\n  const trimmed = raw.trim();\n  switch (field.type) {\n    case \"string\":\n      return trimmed;\n    case \"number\": {\n      const num = Number(trimmed);\n      if (!Number.isFinite(num)) {\n        throw new SignatureParseError(\n          `field '${field.name}' expected number, got '${trimmed}'`,\n          field.name,\n        );\n      }\n      return num;\n    }\n    case \"boolean\": {\n      const lower = trimmed.toLowerCase();\n      if (lower === \"true\" || lower === \"yes\" || lower === \"1\") return true;\n      if (lower === \"false\" || lower === \"no\" || lower === \"0\") return false;\n      throw new SignatureParseError(\n        `field '${field.name}' expected boolean, got '${trimmed}'`,\n        field.name,\n      );\n    }\n    case \"enum\": {\n      const values = field.enumValues ?? [];\n      const match = values.find(\n        (v) => v.toLowerCase() === trimmed.toLowerCase(),\n      );\n      if (!match) {\n        throw new SignatureParseError(\n          `field '${field.name}' expected one of [${values.join(\", \")}], got '${trimmed}'`,\n          field.name,\n        );\n      }\n      return match;\n    }\n  }\n}\n\n/**\n * Convenience constructor for signatures defined as a literal block.\n */\nexport function defineSignature<\n  I extends Record<string, unknown> = Record<string, unknown>,\n  O extends Record<string, unknown> = Record<string, unknown>,\n>(spec: SignatureSpec): Signature<I, O> {\n  return new Signature<I, O>(spec);\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export * from "./backends/native.js";
+export * from "./cli/train.js";
+export * from "./core/cli.js";
+export * from "./core/index.js";
+export * from "./core/privacy-filter.js";
+export * from "./core/skill-scoring-cron.js";
+export * from "./optimizers/index.js";
+export * from "./register-runtime.js";
+export * from "./routes/index.js";
+export * from "./services/index.js";
+export * from "./setup-routes.js";
+export * from "./ui/FineTuningView.helpers.ts";
+export * from "./ui/FineTuningView.js";
+export * from "./ui/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+export * from "./backends/native.js";
+export * from "./cli/train.js";
+export * from "./core/cli.js";
+export * from "./core/index.js";
+export * from "./core/privacy-filter.js";
+export * from "./core/skill-scoring-cron.js";
+export * from "./optimizers/index.js";
+export * from "./register-runtime.js";
+export * from "./routes/index.js";
+export * from "./services/index.js";
+export * from "./setup-routes.js";
+export * from "./ui/FineTuningView.helpers.js";
+export * from "./ui/FineTuningView.js";
+export * from "./ui/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from \"./backends/native.js\";\nexport * from \"./cli/train.js\";\nexport * from \"./core/cli.js\";\nexport * from \"./core/index.js\";\nexport * from \"./core/privacy-filter.js\";\nexport * from \"./core/skill-scoring-cron.js\";\nexport * from \"./optimizers/index.js\";\nexport * from \"./register-runtime.js\";\nexport * from \"./routes/index.js\";\nexport * from \"./services/index.js\";\nexport * from \"./setup-routes.js\";\nexport * from \"./ui/FineTuningView.helpers.js\";\nexport * from \"./ui/FineTuningView.js\";\nexport * from \"./ui/index.js\";\n"],"mappings":"AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}

package/dist/optimizers/bootstrap-fewshot.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Bootstrap-fewshot optimizer.
+ *
+ * Picks the top-K examples from the dataset (ranked by reward, then by
+ * agreement against the baseline) and injects them as in-context
+ * demonstrations into the prompt. The output prompt is the baseline plus a
+ * `Demonstrations:` block that the runtime threads through unchanged.
+ *
+ * This is the cheapest optimizer — it does not propose new instructions, only
+ * conditions the existing prompt on a curated few-shot set. It is the fallback
+ * used when threshold-fired bootstrap runs need fast turnaround.
+ */
+import type { LlmAdapter, OptimizationExample, OptimizerResult, PromptScorer } from "./types.js";
+export interface BootstrapFewshotOptions {
+    /** Number of demonstrations to inject. Defaults to 5. */
+    k?: number;
+    /**
+     * Optional scorer override. When supplied, examples are ranked by score
+     * against the baseline prompt instead of by `example.reward`.
+     */
+    rankByScorer?: boolean;
+}
+export interface BootstrapFewshotInput {
+    baselinePrompt: string;
+    dataset: OptimizationExample[];
+    scorer: PromptScorer;
+    llm: LlmAdapter;
+    options?: BootstrapFewshotOptions;
+}
+/**
+ * Render a demonstration block exactly the way the runtime wires it back into
+ * the system prompt. Public so `OptimizedPromptService` can rebuild the
+ * combined prompt at load time.
+ */
+export declare function renderDemonstrations(examples: OptimizationExample[]): string;
+/**
+ * Combine a baseline prompt with a rendered demonstration block. Idempotent
+ * when `examples` is empty.
+ */
+export declare function withDemonstrations(baseline: string, examples: OptimizationExample[]): string;
+export declare function runBootstrapFewshot(input: BootstrapFewshotInput): Promise<OptimizerResult>;
+//# sourceMappingURL=bootstrap-fewshot.d.ts.map

package/dist/optimizers/bootstrap-fewshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-fewshot.d.ts","sourceRoot":"","sources":["../../src/optimizers/bootstrap-fewshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,mBAAmB,EAEnB,eAAe,EACf,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,uBAAuB;IACtC,yDAAyD;IACzD,CAAC,CAAC,EAAE,MAAM,CAAC;IACX;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,MAAM,EAAE,YAAY,CAAC;IACrB,GAAG,EAAE,UAAU,CAAC;IAChB,OAAO,CAAC,EAAE,uBAAuB,CAAC;CACnC;AAuCD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,mBAAmB,EAAE,GAAG,MAAM,CAY5E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,mBAAmB,EAAE,GAC9B,MAAM,CAIR;AAED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,eAAe,CAAC,CA8B1B"}