@copilotkit/aimock 1.43.0 → 1.45.0

package/dist/fixture-loader.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"fixture-loader.d.cts","names":[],"sources":["../src/fixture-loader.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAoCA;;;;;AAGkB,iBAHF,iBAAA,CAGE,GAAA,EAFX,mBAEW,EAAA,WAAA,CAAA,EADF,WACE,CAAA,EAAf,eAAe;AAkIa,iBAAf,eAAA,CAAe,QAAA,EAAA,MAAA,EAAA,MAAA,CAAA,EAEpB,MAFoB,EAAA,WAAA,CAAA,EAGf,WAHe,CAAA,EAI5B,OAJ4B,EAAA;AAEpB,iBA+BK,mBAAA,CA/BL,OAAA,EAAA,MAAA,EAAA,MAAA,CAAA,EAiCA,MAjCA,EAAA,WAAA,CAAA,EAkCK,WAlCL,CAAA,EAmCR,OAnCQ,EAAA;;;;AA+BX;;;;;;AAoEA;AAIA;AAcA;AAkZA;AAAgC,KApapB,aAAA,GAoaoB;MACpB,EAAA,wBAAA;aACI,EAAA,MAAA;SACb,EAAA,MAAA;CAAgB,GAAA;;;;;UAnaF,gBAAA;;;;;QAKT;;;;;;;;iBASQ,mBAAA,MACT;;;;;;;;;;iBAiZS,gBAAA,WACJ,yBACI,cACb"}
+{"version":3,"file":"fixture-loader.d.cts","names":[],"sources":["../src/fixture-loader.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AA+CA;;;;;AAGkB,iBAHF,iBAAA,CAGE,GAAA,EAFX,mBAEW,EAAA,WAAA,CAAA,EADF,WACE,CAAA,EAAf,eAAe;AAsTlB;;;;;;AAsEA;;;;AAu3CA;AA0EA;;AAGiB,iBA1gDD,eAAA,CA0gDC,QAAA,EAAA,MAAA,EAAA,MAAA,CAAA,EAxgDN,MAwgDM,EAAA,WAAA,CAAA,EAvgDD,WAugDC,CAAA,EAtgDd,OAsgDc,EAAA;;;;;;AA0CjB;;;;;;;;;iBA9+CgB,mBAAA,2BAEL,sBACK,cACb;;;;;;;;;;;;;;KA+CS,aAAA;;;;;;;;;UAOK,gBAAA;;;;;QAKT;;;;;;;;iBASQ,mBAAA,MACT;;;;;;;;;;iBAshBS,gBAAA,WACJ,yBACI,cACb;;;;;;;;;;cA4tBU;KAgBD,gBAAA,WAA2B;;;;;;UAOtB,uBAAA;eACF;;;;;;;;KASH,eAAA,iBACE,0BAA0B,wBAAwB,QAAQ,sBAChE;UAES,oBAAA;;QAET;;;;;;;;;;;;;;;mBAeW;;UAGF,oBAAA;;;;;;;;;;;;;;;;;;;;cA0EJ,gBAAA,SAAyB,KAAA;;;iBAGrB;;;;oBAKG,gCAAgC;YAoBxC;;UAiBK,0BAAA;;;;;;;;;;;;;;cAeJ,sBAAA,SAA+B,KAAA;;iBAE3B;;;UAGW;;;;YAMhB"}

package/dist/fixture-loader.d.ts

@@ -1,5 +1,7 @@
+import { MisbehaviorRule } from "./misbehavior.js";
 import { LiveOptions } from "./live-types.js";
 import { Logger } from "./logger.js";
+import { Message } from "./message-text.js";
 import { Fixture, FixtureFileResponse, FixtureResponse } from "./types.js";
 
 //#region src/fixture-loader.d.ts
@@ -12,7 +14,34 @@ import { Fixture, FixtureFileResponse, FixtureResponse } from "./types.js";
  * shallow clone below.
  */
 declare function normalizeResponse(raw: FixtureFileResponse, liveOptions?: LiveOptions): FixtureResponse;
+/**
+ * @internal Normalize `responsesBlocks` and `customToolCalls` in place, for a
+ * server with `responsesTools: "extended"`: stringify object `arguments` on
+ * `toolCall` blocks, and give a `customToolCalls` entry with no `type` the
+ * type `"custom"`. A custom call's free-text `input` is never stringified.
+ * {@link normalizeResponse} leaves both keys as written, as 1.44.0 did.
+ */
+
+/**
+ * Load the LLM fixtures of one file. Throws a `FixtureLoadError` (rule
+ * `mcp-fakes/loader-cannot-carry-fakes`) when the file has a top-level
+ * `mcpFakes` key; use `loadFixtureFileWithServices` (fixture-loader-services.ts) for such files.
+ */
 declare function loadFixtureFile(filePath: string, logger?: Logger, liveOptions?: LiveOptions): Fixture[];
+/**
+ * The `.json` files (sorted) and the subdirectories (sorted) of `dirPath`,
+ * or `null` when it cannot be read (warned).
+ *
+ * @internal Shared with fixture-loader-services.ts.
+ */
+
+/**
+ * Load the LLM fixtures of every `.json` file under `dirPath`. Throws a
+ * `FixtureLoadError` (rule `mcp-fakes/loader-cannot-carry-fakes`) on the
+ * first file with a top-level `mcpFakes` key; use
+ * `loadFixturesFromDirWithServices` (fixture-loader-services.ts) for such
+ * directories.
+ */
 declare function loadFixturesFromDir(dirPath: string, logger?: Logger, liveOptions?: LiveOptions): Fixture[];
 /**
  * The fixture indices a finding's message NAMES, carried as data.
@@ -60,7 +89,116 @@ declare function renderValidationRef(ref: ValidationRef, renderIndex: (fixtureIn
  */
 
 declare function validateFixtures(fixtures: Fixture[], liveOptions?: LiveOptions): ValidationResult[];
-//# sourceMappingURL=fixture-loader.d.ts.map
+/**
+ * The `rule` values owned by MCP fakes (prefix `mcp-fakes/`). The
+ * bad-block letters: (a) no scope, (b)
+ * malformed scope, (c) shared + deny, (d) bad call entry, (e) duplicate tool,
+ * (f) entry-id or block-id collision, (g) bad block/tool shape, (h) unknown
+ * key on a block, tool or call entry, (i) mcpFakes, or one of its blocks, has
+ * the wrong JSON type, mcpFakes holds no blocks, or an add has an invalid
+ * origin or source item, (j) anyArgs not `true`.
+ */
+declare const MCP_FAKES_LOAD_RULES: readonly ["mcp-fakes/bad-block:a", "mcp-fakes/bad-block:b", "mcp-fakes/bad-block:c", "mcp-fakes/bad-block:d", "mcp-fakes/bad-block:e", "mcp-fakes/bad-block:f", "mcp-fakes/bad-block:g", "mcp-fakes/bad-block:h", "mcp-fakes/bad-block:i", "mcp-fakes/bad-block:j", "mcp-fakes/mount-conflict", "mcp-fakes/loader-cannot-carry-fakes", "mcp-fakes/watch-reload-changed"];
+type McpFakesLoadRule = (typeof MCP_FAKES_LOAD_RULES)[number];
+/**
+ * Every known `FixtureLoadError` rule, by prefix. A feature that throws
+ * `FixtureLoadError` adds its own prefix here, with its rule values as a
+ * union of string literals; a module can add one by declaration merging.
+ */
+interface FixtureLoadRuleRegistry {
+  "mcp-fakes": McpFakesLoadRule;
+}
+/**
+ * A known `FixtureLoadError` rule, namespaced `<prefix>/<name>`. Each
+ * registered value must start with its own prefix and `/` (any other value
+ * drops out of the union), so a misspelled or unregistered rule fails to
+ * compile.
+ */
+type FixtureLoadRule = { [P in keyof FixtureLoadRuleRegistry]: FixtureLoadRuleRegistry[P] & `${P}/${string}` }[keyof FixtureLoadRuleRegistry];
+interface FixtureLoadErrorInit {
+  /** Namespaced `<prefix>/<name>`, one of {@link FixtureLoadRuleRegistry}. */
+  rule: FixtureLoadRule;
+  /** Source of the offending input (path, URL, `control-api#<n>`, `code#<n>`), or null. */
+  file: string | null;
+  /** `<source><load>[<block>]` of the offending block; omit or null when not tied to a block. */
+  blockId?: string | null;
+  /**
+   * Entry id when one entry caused it (bad-block cases d, f, j, and h on a
+   * call entry); omit or null otherwise.
+   */
+  entryId?: string | null;
+  /**
+   * The offending key or value, in words: text, or a `Message` from the
+   * message builder (message-text.ts), whose user parts are quoted and cut
+   * once. Cut to `MCP_FAKES_ECHO_LIMIT` chars in the message (see `capPart`).
+   */
+  detail: string | Message;
+}
+interface FixtureLoadErrorJSON {
+  /** `"FixtureLoadError"`, or a subclass's own name (e.g. `"McpFakesAddError"`). */
+  name: string;
+  rule: string;
+  file: string | null;
+  blockId?: string | null;
+  entryId?: string | null;
+  message: string;
+}
+/**
+ * Thrown for a fixture-load case aimock cannot honor (fail-loud rule). Only
+ * MCP fakes use it (misbehavior throws its own `MisbehaviorConfigError`);
+ * other fixture-loader paths log warnings.
+ * `blockId` and `entryId` are own properties only when supplied, so
+ * `toJSON()` (the control API's HTTP 400 `details`) omits them otherwise.
+ * The message names `file` and every non-null `blockId` and `entryId`, an
+ * empty string as `""`, so it agrees with `toJSON()`. `options.cause` (the
+ * standard `ErrorOptions`) keeps the underlying error, such as a JSON parse
+ * failure; `toJSON()` leaves it out.
+ */
+declare class FixtureLoadError extends Error {
+  /** Typed `string` so a subclass can set its own name. */
+  readonly name: string;
+  readonly rule: FixtureLoadRule;
+  readonly file: string | null;
+  readonly blockId?: string | null;
+  readonly entryId?: string | null;
+  constructor(init: FixtureLoadErrorInit, options?: ErrorOptions);
+  toJSON(): FixtureLoadErrorJSON;
+}
+interface MisbehaviorConfigErrorJSON {
+  /** `"MisbehaviorConfigError"`. */
+  name: string;
+  rule: string;
+  file: string | null;
+  message: string;
+}
+/**
+ * Thrown for an invalid fixture `misbehavior` key, or one that cannot apply
+ * to its fixture, on a server with misbehavior enabled (`enableMisbehavior:
+ * true`, CLI `--misbehavior`). Without that opt-in the key is unused data
+ * and nothing throws. The message has the `FixtureLoadError` layout:
+ * `"<file>": [<rule>] <detail>`.
+ */
+declare class MisbehaviorConfigError extends Error {
+  readonly name: string;
+  readonly rule: MisbehaviorRule;
+  readonly file: string | null;
+  constructor(init: {
+    rule: MisbehaviorRule;
+    file: string | null;
+    detail: string;
+  });
+  toJSON(): MisbehaviorConfigErrorJSON;
+}
+/**
+ * @internal Mark a fixture for a server with `responsesTools: "extended"`,
+ * where that server made the fixture itself (its own load, `--validate`, the
+ * control API): the held `match.toolNamespace` is applied and
+ * `customToolCalls` / `responsesBlocks` are normalized in place, and
+ * `validateFixtures` checks those keys. Idempotent. A fixture the caller
+ * passed in is never marked: an extended server reads it through
+ * {@link responsesToolsExtendedView}, so another server sharing it still sees
+ * it as 1.44.0 loaded it.
+ */
 //#endregion
-export { ValidationRef, ValidationResult, loadFixtureFile, loadFixturesFromDir, normalizeResponse, renderValidationRef, validateFixtures };
+export { FixtureLoadError, FixtureLoadErrorJSON, MisbehaviorConfigError, MisbehaviorConfigErrorJSON, ValidationRef, ValidationResult, loadFixtureFile, loadFixturesFromDir, normalizeResponse, renderValidationRef, validateFixtures };
 //# sourceMappingURL=fixture-loader.d.ts.map

package/dist/fixture-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fixture-loader.d.ts","names":[],"sources":["../src/fixture-loader.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAoCA;;;;;AAGkB,iBAHF,iBAAA,CAGE,GAAA,EAFX,mBAEW,EAAA,WAAA,CAAA,EADF,WACE,CAAA,EAAf,eAAe;AAkIa,iBAAf,eAAA,CAAe,QAAA,EAAA,MAAA,EAAA,MAAA,CAAA,EAEpB,MAFoB,EAAA,WAAA,CAAA,EAGf,WAHe,CAAA,EAI5B,OAJ4B,EAAA;AAEpB,iBA+BK,mBAAA,CA/BL,OAAA,EAAA,MAAA,EAAA,MAAA,CAAA,EAiCA,MAjCA,EAAA,WAAA,CAAA,EAkCK,WAlCL,CAAA,EAmCR,OAnCQ,EAAA;;;;AA+BX;;;;;;AAoEA;AAIA;AAcA;AAkZA;AAAgC,KApapB,aAAA,GAoaoB;MACpB,EAAA,wBAAA;aACI,EAAA,MAAA;SACb,EAAA,MAAA;CAAgB,GAAA;;;;;UAnaF,gBAAA;;;;;QAKT;;;;;;;;iBASQ,mBAAA,MACT;;;;;;;;;;iBAiZS,gBAAA,WACJ,yBACI,cACb"}
+{"version":3,"file":"fixture-loader.d.ts","names":[],"sources":["../src/fixture-loader.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AA+CA;;;;;AAGkB,iBAHF,iBAAA,CAGE,GAAA,EAFX,mBAEW,EAAA,WAAA,CAAA,EADF,WACE,CAAA,EAAf,eAAe;AAsTlB;;;;;;AAsEA;;;;AAu3CA;AA0EA;;AAGiB,iBA1gDD,eAAA,CA0gDC,QAAA,EAAA,MAAA,EAAA,MAAA,CAAA,EAxgDN,MAwgDM,EAAA,WAAA,CAAA,EAvgDD,WAugDC,CAAA,EAtgDd,OAsgDc,EAAA;;;;;;AA0CjB;;;;;;;;;iBA9+CgB,mBAAA,2BAEL,sBACK,cACb;;;;;;;;;;;;;;KA+CS,aAAA;;;;;;;;;UAOK,gBAAA;;;;;QAKT;;;;;;;;iBASQ,mBAAA,MACT;;;;;;;;;;iBAshBS,gBAAA,WACJ,yBACI,cACb;;;;;;;;;;cA4tBU;KAgBD,gBAAA,WAA2B;;;;;;UAOtB,uBAAA;eACF;;;;;;;;KASH,eAAA,iBACE,0BAA0B,wBAAwB,QAAQ,sBAChE;UAES,oBAAA;;QAET;;;;;;;;;;;;;;;mBAeW;;UAGF,oBAAA;;;;;;;;;;;;;;;;;;;;cA0EJ,gBAAA,SAAyB,KAAA;;;iBAGrB;;;;oBAKG,gCAAgC;YAoBxC;;UAiBK,0BAAA;;;;;;;;;;;;;;cAeJ,sBAAA,SAA+B,KAAA;;iBAE3B;;;UAGW;;;;YAMhB"}