@ai-devkit/agent-manager 0.37.0 → 0.38.0

package/dist/harnesses/pi/credentials.js

@@ -0,0 +1,98 @@
+import { readFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+const OPENAI_CREDENTIALS_MISSING = "OpenAI credentials not found; set OPENAI_API_KEY, configure the Pi openai provider, or log in to OpenAI via Pi";
+const ZAI_CREDENTIAL_MISSING = "z.ai API key not found; set Z_AI_API_KEY or configure Pi provider zai";
+function record(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function nonEmptyText(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+function epochMilliseconds(value) {
+    if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) return null;
+    return value > 1e12 ? value : value * 1000;
+}
+async function readPiAuthRoot(options) {
+    const env = options.env ?? process.env;
+    const authPath = join(env.HOME || homedir(), ".pi", "agent", "auth.json");
+    const contents = await (options.readFile ?? readFile)(authPath, "utf8");
+    const parsed = record(JSON.parse(contents));
+    if (!parsed) throw new Error("Pi auth file is malformed");
+    return parsed;
+}
+export async function resolvePiAnthropicCredential(options = {}) {
+    let root;
+    try {
+        root = await readPiAuthRoot(options);
+    } catch (error) {
+        if (record(error)?.code === "ENOENT") {
+            throw new Error("Pi Anthropic OAuth credentials not found");
+        }
+        throw new Error("Pi Anthropic auth file is malformed");
+    }
+    const credential = record(root.anthropic);
+    if (!credential) throw new Error("Pi Anthropic OAuth credentials not found");
+    const access = credential.type === "oauth" ? nonEmptyText(credential.access) : null;
+    if (!access) throw new Error("Pi Anthropic OAuth credential is malformed");
+    return {
+        kind: "oauth",
+        access,
+        expiresMs: epochMilliseconds(credential.expires)
+    };
+}
+export async function resolvePiOpenAiCredential(options = {}) {
+    const env = options.env ?? process.env;
+    const environmentKey = nonEmptyText(env.OPENAI_API_KEY);
+    if (environmentKey) return {
+        kind: "platform",
+        key: environmentKey
+    };
+    let root;
+    try {
+        root = await readPiAuthRoot(options);
+    } catch (error) {
+        if (record(error)?.code === "ENOENT") throw new Error(OPENAI_CREDENTIALS_MISSING);
+        throw new Error("OpenAI Pi auth file is malformed");
+    }
+    const platform = record(root.openai);
+    if (platform) {
+        const key = platform.type === "api_key" ? nonEmptyText(platform.key) : null;
+        if (!key) throw new Error("OpenAI Pi auth file has a malformed openai credential");
+        return {
+            kind: "platform",
+            key
+        };
+    }
+    const oauth = record(root["openai-codex"]);
+    const access = oauth?.type === "oauth" ? nonEmptyText(oauth.access) : null;
+    const accountId = nonEmptyText(oauth?.accountId);
+    if (oauth && access && accountId) {
+        return {
+            kind: "oauth",
+            access,
+            accountId,
+            expiresMs: epochMilliseconds(oauth.expires)
+        };
+    }
+    throw new Error(OPENAI_CREDENTIALS_MISSING);
+}
+export async function resolvePiZaiApiKey(options = {}) {
+    const env = options.env ?? process.env;
+    const environmentKey = nonEmptyText(env.Z_AI_API_KEY);
+    if (environmentKey) return environmentKey;
+    let root;
+    try {
+        root = await readPiAuthRoot(options);
+    } catch (error) {
+        if (record(error)?.code === "ENOENT") throw new Error(ZAI_CREDENTIAL_MISSING);
+        throw new Error("z.ai Pi auth file is malformed");
+    }
+    const credential = record(root.zai);
+    if (!credential) throw new Error(ZAI_CREDENTIAL_MISSING);
+    const key = credential.type === "api_key" ? nonEmptyText(credential.key) : null;
+    if (!key) throw new Error("z.ai Pi auth file has a malformed zai credential");
+    return key;
+}
+
+//# sourceMappingURL=credentials.js.map

package/dist/harnesses/pi/credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/harnesses/pi/credentials.ts"],"sourcesContent":["import { readFile } from \"node:fs/promises\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\n\ntype UnknownRecord = Record<string, unknown>;\n\nexport type PiCredentialOptions = {\n  env?: NodeJS.ProcessEnv;\n  readFile?: (path: string, encoding: BufferEncoding) => Promise<string>;\n};\n\nexport type PiAnthropicCredential = {\n  kind: \"oauth\";\n  access: string;\n  expiresMs: number | null;\n};\n\nexport type PiOpenAiCredential =\n  | { kind: \"platform\"; key: string }\n  | { kind: \"oauth\"; access: string; accountId: string; expiresMs: number | null };\n\nconst OPENAI_CREDENTIALS_MISSING =\n  \"OpenAI credentials not found; set OPENAI_API_KEY, configure the Pi openai provider, or log in to OpenAI via Pi\";\nconst ZAI_CREDENTIAL_MISSING =\n  \"z.ai API key not found; set Z_AI_API_KEY or configure Pi provider zai\";\n\nfunction record(value: unknown): UnknownRecord | null {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value)\n    ? (value as UnknownRecord)\n    : null;\n}\n\nfunction nonEmptyText(value: unknown): string | null {\n  return typeof value === \"string\" && value.trim() ? value.trim() : null;\n}\n\nfunction epochMilliseconds(value: unknown): number | null {\n  if (typeof value !== \"number\" || !Number.isFinite(value) || value <= 0) return null;\n  return value > 1e12 ? value : value * 1000;\n}\n\nasync function readPiAuthRoot(options: PiCredentialOptions): Promise<UnknownRecord> {\n  const env = options.env ?? process.env;\n  const authPath = join(env.HOME || homedir(), \".pi\", \"agent\", \"auth.json\");\n  const contents = await (options.readFile ?? readFile)(authPath, \"utf8\");\n  const parsed = record(JSON.parse(contents));\n  if (!parsed) throw new Error(\"Pi auth file is malformed\");\n  return parsed;\n}\n\nexport async function resolvePiAnthropicCredential(\n  options: PiCredentialOptions = {},\n): Promise<PiAnthropicCredential> {\n  let root: UnknownRecord;\n  try {\n    root = await readPiAuthRoot(options);\n  } catch (error) {\n    if (record(error)?.code === \"ENOENT\") {\n      throw new Error(\"Pi Anthropic OAuth credentials not found\");\n    }\n    throw new Error(\"Pi Anthropic auth file is malformed\");\n  }\n\n  const credential = record(root.anthropic);\n  if (!credential) throw new Error(\"Pi Anthropic OAuth credentials not found\");\n  const access = credential.type === \"oauth\" ? nonEmptyText(credential.access) : null;\n  if (!access) throw new Error(\"Pi Anthropic OAuth credential is malformed\");\n  return {\n    kind: \"oauth\",\n    access,\n    expiresMs: epochMilliseconds(credential.expires),\n  };\n}\n\nexport async function resolvePiOpenAiCredential(\n  options: PiCredentialOptions = {},\n): Promise<PiOpenAiCredential> {\n  const env = options.env ?? process.env;\n  const environmentKey = nonEmptyText(env.OPENAI_API_KEY);\n  if (environmentKey) return { kind: \"platform\", key: environmentKey };\n\n  let root: UnknownRecord;\n  try {\n    root = await readPiAuthRoot(options);\n  } catch (error) {\n    if (record(error)?.code === \"ENOENT\") throw new Error(OPENAI_CREDENTIALS_MISSING);\n    throw new Error(\"OpenAI Pi auth file is malformed\");\n  }\n\n  const platform = record(root.openai);\n  if (platform) {\n    const key = platform.type === \"api_key\" ? nonEmptyText(platform.key) : null;\n    if (!key) throw new Error(\"OpenAI Pi auth file has a malformed openai credential\");\n    return { kind: \"platform\", key };\n  }\n\n  const oauth = record(root[\"openai-codex\"]);\n  const access = oauth?.type === \"oauth\" ? nonEmptyText(oauth.access) : null;\n  const accountId = nonEmptyText(oauth?.accountId);\n  if (oauth && access && accountId) {\n    return {\n      kind: \"oauth\",\n      access,\n      accountId,\n      expiresMs: epochMilliseconds(oauth.expires),\n    };\n  }\n  throw new Error(OPENAI_CREDENTIALS_MISSING);\n}\n\nexport async function resolvePiZaiApiKey(options: PiCredentialOptions = {}): Promise<string> {\n  const env = options.env ?? process.env;\n  const environmentKey = nonEmptyText(env.Z_AI_API_KEY);\n  if (environmentKey) return environmentKey;\n\n  let root: UnknownRecord;\n  try {\n    root = await readPiAuthRoot(options);\n  } catch (error) {\n    if (record(error)?.code === \"ENOENT\") throw new Error(ZAI_CREDENTIAL_MISSING);\n    throw new Error(\"z.ai Pi auth file is malformed\");\n  }\n\n  const credential = record(root.zai);\n  if (!credential) throw new Error(ZAI_CREDENTIAL_MISSING);\n  const key = credential.type === \"api_key\" ? nonEmptyText(credential.key) : null;\n  if (!key) throw new Error(\"z.ai Pi auth file has a malformed zai credential\");\n  return key;\n}\n"],"names":["readFile","homedir","join","OPENAI_CREDENTIALS_MISSING","ZAI_CREDENTIAL_MISSING","record","value","Array","isArray","nonEmptyText","trim","epochMilliseconds","Number","isFinite","readPiAuthRoot","options","env","process","authPath","HOME","contents","parsed","JSON","parse","Error","resolvePiAnthropicCredential","root","error","code","credential","anthropic","access","type","kind","expiresMs","expires","resolvePiOpenAiCredential","environmentKey","OPENAI_API_KEY","key","platform","openai","oauth","accountId","resolvePiZaiApiKey","Z_AI_API_KEY","zai"],"mappings":"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"}

package/dist/harnesses/pi/readiness.d.ts

@@ -0,0 +1,3 @@
+import type { HarnessReadinessProfile } from "../readiness/types.js";
+export declare const piReadiness: HarnessReadinessProfile;
+//# sourceMappingURL=readiness.d.ts.map

package/dist/harnesses/pi/readiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness.d.ts","sourceRoot":"","sources":["../../../src/harnesses/pi/readiness.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAEV,uBAAuB,EAGxB,MAAM,uBAAuB,CAAC;AAsF/B,eAAO,MAAM,WAAW,EAAE,uBAIzB,CAAC"}

package/dist/harnesses/pi/readiness.js

@@ -0,0 +1,96 @@
+import { join } from "node:path";
+import { displayHome, mappingCheck, nonEmpty, record, worstReadinessStatus } from "../readiness/checks.js";
+function providerNames(parsed) {
+    const names = new Set();
+    if (nonEmpty(parsed.provider)) names.add(parsed.provider.trim());
+    const providers = record(parsed.providers);
+    if (providers) {
+        for (const name of Object.keys(providers)){
+            if (name.trim()) names.add(name);
+        }
+    }
+    for (const [name, value] of Object.entries(parsed)){
+        if (name === "provider" || name === "providers") continue;
+        if (record(value) && name.trim()) names.add(name);
+    }
+    return [
+        ...names
+    ].sort();
+}
+async function authCheck(runtime) {
+    const sourcePath = join(runtime.homeDir, ".pi", "agent", "auth.json");
+    try {
+        const parsed = record(JSON.parse(await runtime.readFile(sourcePath)));
+        if (!parsed) throw new Error("invalid");
+        const availableProviders = providerNames(parsed);
+        const provider = nonEmpty(parsed.provider) ? parsed.provider.trim() : null;
+        const authenticated = availableProviders.length > 0;
+        return {
+            state: authenticated ? "authenticated" : "unauthenticated",
+            source: displayHome(sourcePath, runtime.homeDir),
+            provider,
+            availableProviders,
+            status: authenticated ? "pass" : "fail",
+            errors: authenticated ? [] : [
+                "Pi credential file has no configured model provider"
+            ]
+        };
+    } catch  {
+        return {
+            state: "unauthenticated",
+            source: displayHome(sourcePath, runtime.homeDir),
+            provider: null,
+            availableProviders: [],
+            status: "fail",
+            errors: [
+                "Pi credential file is missing or invalid"
+            ]
+        };
+    }
+}
+function isSessionTrackerListed(output) {
+    const normalized = output.toLowerCase();
+    return normalized.includes("@ai-devkit/pi-session-tracker") || /\bsession[\s-]+tracker\b/.test(normalized);
+}
+async function integrationCheck(runtime) {
+    let installed = false;
+    try {
+        const result = await runtime.runCommand("pi", [
+            "list"
+        ]);
+        installed = isSessionTrackerListed(result.stdout);
+    } catch  {
+    // Safe fixed result below.
+    }
+    const mapping = await mappingCheck(join(runtime.homeDir, ".pi", "agent", "sessions.json"), runtime);
+    const mappingStatus = mapping.valid || !mapping.present ? "pass" : "fail";
+    const status = worstReadinessStatus([
+        installed ? "pass" : "fail",
+        mappingStatus
+    ]);
+    return {
+        label: "ai-devkit plugin",
+        installed,
+        status,
+        errors: [
+            ...!installed ? [
+                "Pi session tracker is not registered"
+            ] : [],
+            ...mappingStatus === "fail" ? mapping.errors : []
+        ],
+        details: {
+            package: "@ai-devkit/pi-session-tracker",
+            registryPath: mapping.path,
+            registryValid: mapping.valid,
+            invalidEntries: mapping.invalidEntries,
+            staleEntries: mapping.staleEntries
+        }
+    };
+}
+export const piReadiness = {
+    configDir: ".pi",
+    auth: authCheck,
+    integration: integrationCheck
+};
+
+//# sourceMappingURL=readiness.js.map

package/dist/harnesses/pi/readiness.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/harnesses/pi/readiness.ts"],"sourcesContent":["import { join } from \"node:path\";\nimport {\n  displayHome,\n  mappingCheck,\n  nonEmpty,\n  record,\n  worstReadinessStatus,\n} from \"../readiness/checks.js\";\nimport type {\n  AuthReadinessCheck,\n  HarnessReadinessProfile,\n  IntegrationReadinessCheck,\n  ReadinessRuntime,\n} from \"../readiness/types.js\";\n\nfunction providerNames(parsed: Record<string, unknown>): string[] {\n  const names = new Set<string>();\n  if (nonEmpty(parsed.provider)) names.add((parsed.provider as string).trim());\n  const providers = record(parsed.providers);\n  if (providers) {\n    for (const name of Object.keys(providers)) {\n      if (name.trim()) names.add(name);\n    }\n  }\n  for (const [name, value] of Object.entries(parsed)) {\n    if (name === \"provider\" || name === \"providers\") continue;\n    if (record(value) && name.trim()) names.add(name);\n  }\n  return [...names].sort();\n}\n\nasync function authCheck(runtime: ReadinessRuntime): Promise<AuthReadinessCheck> {\n  const sourcePath = join(runtime.homeDir, \".pi\", \"agent\", \"auth.json\");\n  try {\n    const parsed = record(JSON.parse(await runtime.readFile(sourcePath)));\n    if (!parsed) throw new Error(\"invalid\");\n    const availableProviders = providerNames(parsed);\n    const provider = nonEmpty(parsed.provider) ? (parsed.provider as string).trim() : null;\n    const authenticated = availableProviders.length > 0;\n    return {\n      state: authenticated ? \"authenticated\" : \"unauthenticated\",\n      source: displayHome(sourcePath, runtime.homeDir),\n      provider,\n      availableProviders,\n      status: authenticated ? \"pass\" : \"fail\",\n      errors: authenticated ? [] : [\"Pi credential file has no configured model provider\"],\n    };\n  } catch {\n    return {\n      state: \"unauthenticated\",\n      source: displayHome(sourcePath, runtime.homeDir),\n      provider: null,\n      availableProviders: [],\n      status: \"fail\",\n      errors: [\"Pi credential file is missing or invalid\"],\n    };\n  }\n}\n\nfunction isSessionTrackerListed(output: string): boolean {\n  const normalized = output.toLowerCase();\n  return (\n    normalized.includes(\"@ai-devkit/pi-session-tracker\") ||\n    /\\bsession[\\s-]+tracker\\b/.test(normalized)\n  );\n}\n\nasync function integrationCheck(runtime: ReadinessRuntime): Promise<IntegrationReadinessCheck> {\n  let installed = false;\n  try {\n    const result = await runtime.runCommand(\"pi\", [\"list\"]);\n    installed = isSessionTrackerListed(result.stdout);\n  } catch {\n    // Safe fixed result below.\n  }\n  const mapping = await mappingCheck(\n    join(runtime.homeDir, \".pi\", \"agent\", \"sessions.json\"),\n    runtime,\n  );\n  const mappingStatus = mapping.valid || !mapping.present ? \"pass\" : \"fail\";\n  const status = worstReadinessStatus([installed ? \"pass\" : \"fail\", mappingStatus]);\n  return {\n    label: \"ai-devkit plugin\",\n    installed,\n    status,\n    errors: [\n      ...(!installed ? [\"Pi session tracker is not registered\"] : []),\n      ...(mappingStatus === \"fail\" ? mapping.errors : []),\n    ],\n    details: {\n      package: \"@ai-devkit/pi-session-tracker\",\n      registryPath: mapping.path,\n      registryValid: mapping.valid,\n      invalidEntries: mapping.invalidEntries,\n      staleEntries: mapping.staleEntries,\n    },\n  };\n}\n\nexport const piReadiness: HarnessReadinessProfile = {\n  configDir: \".pi\",\n  auth: authCheck,\n  integration: integrationCheck,\n};\n"],"names":["join","displayHome","mappingCheck","nonEmpty","record","worstReadinessStatus","providerNames","parsed","names","Set","provider","add","trim","providers","name","Object","keys","value","entries","sort","authCheck","runtime","sourcePath","homeDir","JSON","parse","readFile","Error","availableProviders","authenticated","length","state","source","status","errors","isSessionTrackerListed","output","normalized","toLowerCase","includes","test","integrationCheck","installed","result","runCommand","stdout","mapping","mappingStatus","valid","present","label","details","package","registryPath","path","registryValid","invalidEntries","staleEntries","piReadiness","configDir","auth","integration"],"mappings":"AAAA,SAASA,IAAI,QAAQ,YAAY;AACjC,SACEC,WAAW,EACXC,YAAY,EACZC,QAAQ,EACRC,MAAM,EACNC,oBAAoB,QACf,yBAAyB;AAQhC,SAASC,cAAcC,MAA+B;IACpD,MAAMC,QAAQ,IAAIC;IAClB,IAAIN,SAASI,OAAOG,QAAQ,GAAGF,MAAMG,GAAG,CAAC,AAACJ,OAAOG,QAAQ,CAAYE,IAAI;IACzE,MAAMC,YAAYT,OAAOG,OAAOM,SAAS;IACzC,IAAIA,WAAW;QACb,KAAK,MAAMC,QAAQC,OAAOC,IAAI,CAACH,WAAY;YACzC,IAAIC,KAAKF,IAAI,IAAIJ,MAAMG,GAAG,CAACG;QAC7B;IACF;IACA,KAAK,MAAM,CAACA,MAAMG,MAAM,IAAIF,OAAOG,OAAO,CAACX,QAAS;QAClD,IAAIO,SAAS,cAAcA,SAAS,aAAa;QACjD,IAAIV,OAAOa,UAAUH,KAAKF,IAAI,IAAIJ,MAAMG,GAAG,CAACG;IAC9C;IACA,OAAO;WAAIN;KAAM,CAACW,IAAI;AACxB;AAEA,eAAeC,UAAUC,OAAyB;IAChD,MAAMC,aAAatB,KAAKqB,QAAQE,OAAO,EAAE,OAAO,SAAS;IACzD,IAAI;QACF,MAAMhB,SAASH,OAAOoB,KAAKC,KAAK,CAAC,MAAMJ,QAAQK,QAAQ,CAACJ;QACxD,IAAI,CAACf,QAAQ,MAAM,IAAIoB,MAAM;QAC7B,MAAMC,qBAAqBtB,cAAcC;QACzC,MAAMG,WAAWP,SAASI,OAAOG,QAAQ,IAAI,AAACH,OAAOG,QAAQ,CAAYE,IAAI,KAAK;QAClF,MAAMiB,gBAAgBD,mBAAmBE,MAAM,GAAG;QAClD,OAAO;YACLC,OAAOF,gBAAgB,kBAAkB;YACzCG,QAAQ/B,YAAYqB,YAAYD,QAAQE,OAAO;YAC/Cb;YACAkB;YACAK,QAAQJ,gBAAgB,SAAS;YACjCK,QAAQL,gBAAgB,EAAE,GAAG;gBAAC;aAAsD;QACtF;IACF,EAAE,OAAM;QACN,OAAO;YACLE,OAAO;YACPC,QAAQ/B,YAAYqB,YAAYD,QAAQE,OAAO;YAC/Cb,UAAU;YACVkB,oBAAoB,EAAE;YACtBK,QAAQ;YACRC,QAAQ;gBAAC;aAA2C;QACtD;IACF;AACF;AAEA,SAASC,uBAAuBC,MAAc;IAC5C,MAAMC,aAAaD,OAAOE,WAAW;IACrC,OACED,WAAWE,QAAQ,CAAC,oCACpB,2BAA2BC,IAAI,CAACH;AAEpC;AAEA,eAAeI,iBAAiBpB,OAAyB;IACvD,IAAIqB,YAAY;IAChB,IAAI;QACF,MAAMC,SAAS,MAAMtB,QAAQuB,UAAU,CAAC,MAAM;YAAC;SAAO;QACtDF,YAAYP,uBAAuBQ,OAAOE,MAAM;IAClD,EAAE,OAAM;IACN,2BAA2B;IAC7B;IACA,MAAMC,UAAU,MAAM5C,aACpBF,KAAKqB,QAAQE,OAAO,EAAE,OAAO,SAAS,kBACtCF;IAEF,MAAM0B,gBAAgBD,QAAQE,KAAK,IAAI,CAACF,QAAQG,OAAO,GAAG,SAAS;IACnE,MAAMhB,SAAS5B,qBAAqB;QAACqC,YAAY,SAAS;QAAQK;KAAc;IAChF,OAAO;QACLG,OAAO;QACPR;QACAT;QACAC,QAAQ;eACF,CAACQ,YAAY;gBAAC;aAAuC,GAAG,EAAE;eAC1DK,kBAAkB,SAASD,QAAQZ,MAAM,GAAG,EAAE;SACnD;QACDiB,SAAS;YACPC,SAAS;YACTC,cAAcP,QAAQQ,IAAI;YAC1BC,eAAeT,QAAQE,KAAK;YAC5BQ,gBAAgBV,QAAQU,cAAc;YACtCC,cAAcX,QAAQW,YAAY;QACpC;IACF;AACF;AAEA,OAAO,MAAMC,cAAuC;IAClDC,WAAW;IACXC,MAAMxC;IACNyC,aAAapB;AACf,EAAE"}

package/dist/harnesses/readiness/AgentReadiness.d.ts

@@ -0,0 +1,6 @@
+import { type AgentReadinessOptions, type AgentReadinessReport, type ReadinessAgentType } from "./types.js";
+export declare function getAgentReadinessReport(agent: ReadinessAgentType, options?: AgentReadinessOptions): Promise<AgentReadinessReport>;
+export declare function getAgentReadinessReports(options?: AgentReadinessOptions): Promise<Record<ReadinessAgentType, AgentReadinessReport>>;
+export { worstReadinessStatus } from "./checks.js";
+export type { AgentReadinessOptions, AgentReadinessReport, ReadinessAgentType, ReadinessStatus, } from "./types.js";
+//# sourceMappingURL=AgentReadiness.d.ts.map

package/dist/harnesses/readiness/AgentReadiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentReadiness.d.ts","sourceRoot":"","sources":["../../../src/harnesses/readiness/AgentReadiness.ts"],"names":[],"mappings":"AAYA,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAEzB,KAAK,kBAAkB,EAExB,MAAM,YAAY,CAAC;AAcpB,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,kBAAkB,EACzB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,oBAAoB,CAAC,CAE/B;AA8BD,wBAAsB,wBAAwB,CAC5C,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,oBAAoB,CAAC,CAAC,CAQ3D;AAED,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/harnesses/readiness/AgentReadiness.js

@@ -0,0 +1,68 @@
+import { claudeReadiness } from "../claude/readiness.js";
+import { codexReadiness } from "../codex/readiness.js";
+import { copilotReadiness } from "../copilot/readiness.js";
+import { openCodeReadiness } from "../opencode/readiness.js";
+import { piReadiness } from "../pi/readiness.js";
+import { builtInSkillsCheck, createReadinessRuntime, directoryCheck, executableCheck, worstReadinessStatus } from "./checks.js";
+import { READINESS_AGENT_TYPES } from "./types.js";
+const READINESS_PROFILES = {
+    claude: claudeReadiness,
+    codex: codexReadiness,
+    gemini_cli: {
+        configDir: ".gemini"
+    },
+    grok_cli: {
+        configDir: ".grok"
+    },
+    kiro: {
+        configDir: ".kiro"
+    },
+    antigravity_cli: {
+        configDir: ".gemini/antigravity-cli"
+    },
+    opencode: openCodeReadiness,
+    copilot: copilotReadiness,
+    pi: piReadiness
+};
+export async function getAgentReadinessReport(agent, options = {}) {
+    return agentReadiness(agent, createReadinessRuntime(options));
+}
+async function agentReadiness(agent, runtime) {
+    const profile = READINESS_PROFILES[agent];
+    const [executable, globalConfig, builtInSkills, auth, integration] = await Promise.all([
+        executableCheck(agent, runtime),
+        directoryCheck(profile.configDir, runtime),
+        builtInSkillsCheck(agent, runtime),
+        profile.auth?.(runtime),
+        profile.integration?.(runtime)
+    ]);
+    return {
+        type: agent,
+        executable,
+        globalConfig,
+        builtInSkills,
+        auth,
+        integration,
+        status: worstReadinessStatus([
+            executable.status,
+            globalConfig.status,
+            ...auth ? [
+                auth.status
+            ] : [],
+            ...integration ? [
+                integration.status
+            ] : []
+        ])
+    };
+}
+export async function getAgentReadinessReports(options = {}) {
+    const runtime = createReadinessRuntime(options);
+    const entries = await Promise.all(READINESS_AGENT_TYPES.map(async (agent)=>[
+            agent,
+            await agentReadiness(agent, runtime)
+        ]));
+    return Object.fromEntries(entries);
+}
+export { worstReadinessStatus } from "./checks.js";
+
+//# sourceMappingURL=AgentReadiness.js.map

package/dist/harnesses/readiness/AgentReadiness.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/harnesses/readiness/AgentReadiness.ts"],"sourcesContent":["import { claudeReadiness } from \"../claude/readiness.js\";\nimport { codexReadiness } from \"../codex/readiness.js\";\nimport { copilotReadiness } from \"../copilot/readiness.js\";\nimport { openCodeReadiness } from \"../opencode/readiness.js\";\nimport { piReadiness } from \"../pi/readiness.js\";\nimport {\n  builtInSkillsCheck,\n  createReadinessRuntime,\n  directoryCheck,\n  executableCheck,\n  worstReadinessStatus,\n} from \"./checks.js\";\nimport {\n  READINESS_AGENT_TYPES,\n  type AgentReadinessOptions,\n  type AgentReadinessReport,\n  type HarnessReadinessProfile,\n  type ReadinessAgentType,\n  type ReadinessRuntime,\n} from \"./types.js\";\n\nconst READINESS_PROFILES: Record<ReadinessAgentType, HarnessReadinessProfile> = {\n  claude: claudeReadiness,\n  codex: codexReadiness,\n  gemini_cli: { configDir: \".gemini\" },\n  grok_cli: { configDir: \".grok\" },\n  kiro: { configDir: \".kiro\" },\n  antigravity_cli: { configDir: \".gemini/antigravity-cli\" },\n  opencode: openCodeReadiness,\n  copilot: copilotReadiness,\n  pi: piReadiness,\n};\n\nexport async function getAgentReadinessReport(\n  agent: ReadinessAgentType,\n  options: AgentReadinessOptions = {},\n): Promise<AgentReadinessReport> {\n  return agentReadiness(agent, createReadinessRuntime(options));\n}\n\nasync function agentReadiness(\n  agent: ReadinessAgentType,\n  runtime: ReadinessRuntime,\n): Promise<AgentReadinessReport> {\n  const profile = READINESS_PROFILES[agent];\n  const [executable, globalConfig, builtInSkills, auth, integration] = await Promise.all([\n    executableCheck(agent, runtime),\n    directoryCheck(profile.configDir, runtime),\n    builtInSkillsCheck(agent, runtime),\n    profile.auth?.(runtime),\n    profile.integration?.(runtime),\n  ]);\n  return {\n    type: agent,\n    executable,\n    globalConfig,\n    builtInSkills,\n    auth,\n    integration,\n    status: worstReadinessStatus([\n      executable.status,\n      globalConfig.status,\n      ...(auth ? [auth.status] : []),\n      ...(integration ? [integration.status] : []),\n    ]),\n  };\n}\n\nexport async function getAgentReadinessReports(\n  options: AgentReadinessOptions = {},\n): Promise<Record<ReadinessAgentType, AgentReadinessReport>> {\n  const runtime = createReadinessRuntime(options);\n  const entries = await Promise.all(\n    READINESS_AGENT_TYPES.map(\n      async (agent) => [agent, await agentReadiness(agent, runtime)] as const,\n    ),\n  );\n  return Object.fromEntries(entries) as Record<ReadinessAgentType, AgentReadinessReport>;\n}\n\nexport { worstReadinessStatus } from \"./checks.js\";\nexport type {\n  AgentReadinessOptions,\n  AgentReadinessReport,\n  ReadinessAgentType,\n  ReadinessStatus,\n} from \"./types.js\";\n"],"names":["claudeReadiness","codexReadiness","copilotReadiness","openCodeReadiness","piReadiness","builtInSkillsCheck","createReadinessRuntime","directoryCheck","executableCheck","worstReadinessStatus","READINESS_AGENT_TYPES","READINESS_PROFILES","claude","codex","gemini_cli","configDir","grok_cli","kiro","antigravity_cli","opencode","copilot","pi","getAgentReadinessReport","agent","options","agentReadiness","runtime","profile","executable","globalConfig","builtInSkills","auth","integration","Promise","all","type","status","getAgentReadinessReports","entries","map","Object","fromEntries"],"mappings":"AAAA,SAASA,eAAe,QAAQ,yBAAyB;AACzD,SAASC,cAAc,QAAQ,wBAAwB;AACvD,SAASC,gBAAgB,QAAQ,0BAA0B;AAC3D,SAASC,iBAAiB,QAAQ,2BAA2B;AAC7D,SAASC,WAAW,QAAQ,qBAAqB;AACjD,SACEC,kBAAkB,EAClBC,sBAAsB,EACtBC,cAAc,EACdC,eAAe,EACfC,oBAAoB,QACf,cAAc;AACrB,SACEC,qBAAqB,QAMhB,aAAa;AAEpB,MAAMC,qBAA0E;IAC9EC,QAAQZ;IACRa,OAAOZ;IACPa,YAAY;QAAEC,WAAW;IAAU;IACnCC,UAAU;QAAED,WAAW;IAAQ;IAC/BE,MAAM;QAAEF,WAAW;IAAQ;IAC3BG,iBAAiB;QAAEH,WAAW;IAA0B;IACxDI,UAAUhB;IACViB,SAASlB;IACTmB,IAAIjB;AACN;AAEA,OAAO,eAAekB,wBACpBC,KAAyB,EACzBC,UAAiC,CAAC,CAAC;IAEnC,OAAOC,eAAeF,OAAOjB,uBAAuBkB;AACtD;AAEA,eAAeC,eACbF,KAAyB,EACzBG,OAAyB;IAEzB,MAAMC,UAAUhB,kBAAkB,CAACY,MAAM;IACzC,MAAM,CAACK,YAAYC,cAAcC,eAAeC,MAAMC,YAAY,GAAG,MAAMC,QAAQC,GAAG,CAAC;QACrF1B,gBAAgBe,OAAOG;QACvBnB,eAAeoB,QAAQZ,SAAS,EAAEW;QAClCrB,mBAAmBkB,OAAOG;QAC1BC,QAAQI,IAAI,GAAGL;QACfC,QAAQK,WAAW,GAAGN;KACvB;IACD,OAAO;QACLS,MAAMZ;QACNK;QACAC;QACAC;QACAC;QACAC;QACAI,QAAQ3B,qBAAqB;YAC3BmB,WAAWQ,MAAM;YACjBP,aAAaO,MAAM;eACfL,OAAO;gBAACA,KAAKK,MAAM;aAAC,GAAG,EAAE;eACzBJ,cAAc;gBAACA,YAAYI,MAAM;aAAC,GAAG,EAAE;SAC5C;IACH;AACF;AAEA,OAAO,eAAeC,yBACpBb,UAAiC,CAAC,CAAC;IAEnC,MAAME,UAAUpB,uBAAuBkB;IACvC,MAAMc,UAAU,MAAML,QAAQC,GAAG,CAC/BxB,sBAAsB6B,GAAG,CACvB,OAAOhB,QAAU;YAACA;YAAO,MAAME,eAAeF,OAAOG;SAAS;IAGlE,OAAOc,OAAOC,WAAW,CAACH;AAC5B;AAEA,SAAS7B,oBAAoB,QAAQ,cAAc"}

package/dist/harnesses/readiness/checks.d.ts

@@ -0,0 +1,31 @@
+import type { AgentReadinessOptions, BuiltInSkillsReadinessCheck, DirectoryReadinessCheck, ExecutableReadinessCheck, ReadinessAgentType, ReadinessCheck, ReadinessRuntime, ReadinessStatus } from "./types.js";
+export declare function createReadinessRuntime(options: AgentReadinessOptions): ReadinessRuntime;
+export declare function worstReadinessStatus(statuses: ReadinessStatus[]): ReadinessStatus;
+export declare function displayHome(target: string, homeDir: string): string;
+export declare function record(value: unknown): Record<string, unknown> | null;
+export declare function nonEmpty(value: unknown): boolean;
+export declare function accessible(target: string, runtime: ReadinessRuntime, mode?: number): Promise<boolean>;
+export declare function executableCheck(agent: ReadinessAgentType, runtime: ReadinessRuntime): Promise<ExecutableReadinessCheck>;
+export declare function directoryCheck(configDir: string, runtime: ReadinessRuntime): Promise<DirectoryReadinessCheck>;
+export declare function builtInSkillsCheck(agent: ReadinessAgentType, runtime: ReadinessRuntime): Promise<BuiltInSkillsReadinessCheck>;
+export declare function scriptCheck(installed: string, bundled: string, runtime: ReadinessRuntime): Promise<ReadinessCheck & {
+    path: string;
+    present: boolean;
+    readable: boolean;
+    matchesBundledAsset: boolean;
+}>;
+export declare function registrationCheck(target: string, event: string, command: string, runtime: ReadinessRuntime): Promise<ReadinessCheck & {
+    path: string;
+    event: string;
+    command: string;
+    present: boolean;
+    valid: boolean;
+}>;
+export declare function mappingCheck(target: string, runtime: ReadinessRuntime): Promise<ReadinessCheck & {
+    path: string;
+    present: boolean;
+    valid: boolean;
+    invalidEntries: number;
+    staleEntries: number;
+}>;
+//# sourceMappingURL=checks.d.ts.map

package/dist/harnesses/readiness/checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checks.d.ts","sourceRoot":"","sources":["../../../src/harnesses/readiness/checks.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,qBAAqB,EACrB,2BAA2B,EAC3B,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,eAAe,EAChB,MAAM,YAAY,CAAC;AAIpB,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,qBAAqB,GAAG,gBAAgB,CAYvF;AAeD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,eAAe,CAKjF;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAMnE;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAIrE;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEhD;AAED,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,gBAAgB,EACzB,IAAI,SAAiB,GACpB,OAAO,CAAC,OAAO,CAAC,CAOlB;AAmBD,wBAAsB,eAAe,CACnC,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,wBAAwB,CAAC,CASnC;AAED,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,uBAAuB,CAAC,CAUlC;AAED,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,2BAA2B,CAAC,CA6BtC;AAED,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,gBAAgB,GACxB,OAAO,CACR,cAAc,GAAG;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,mBAAmB,EAAE,OAAO,CAAC;CAC9B,CACF,CAmCA;AAkBD,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,gBAAgB,GACxB,OAAO,CACR,cAAc,GAAG;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB,CACF,CAwBA;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,gBAAgB,GACxB,OAAO,CACR,cAAc,GAAG;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB,CACF,CAwDA"}

package/dist/harnesses/readiness/checks.js

@@ -0,0 +1,270 @@
+import { execFile } from "node:child_process";
+import { constants } from "node:fs";
+import { access as fsAccess, readFile as fsReadFile } from "node:fs/promises";
+import { delimiter, join } from "node:path";
+import { promisify } from "node:util";
+import { getCodexCapacityReport } from "../../capacity/index.js";
+import { HARNESS_RUNTIME_PROFILES } from "../runtimeProfiles.js";
+const execFileAsync = promisify(execFile);
+export function createReadinessRuntime(options) {
+    return {
+        homeDir: options.homeDir ?? process.env.HOME ?? "",
+        path: options.path ?? process.env.PATH ?? "",
+        assetRoot: options.assetRoot ?? null,
+        builtInSkillNames: options.builtInSkillNames ?? [],
+        skillRoots: options.skillRoots ?? {},
+        readFile: options.readFile ?? ((target)=>fsReadFile(target, "utf8")),
+        access: options.access ?? ((target, mode = constants.R_OK)=>fsAccess(target, mode)),
+        runCommand: options.runCommand ?? defaultRunCommand,
+        codexAuth: options.codexAuth ?? (async ()=>(await getCodexCapacityReport()).authenticated)
+    };
+}
+async function defaultRunCommand(command, args) {
+    const result = await execFileAsync(command, args, {
+        encoding: "utf8",
+        timeout: 5000,
+        maxBuffer: 1024 * 1024
+    });
+    return {
+        stdout: result.stdout,
+        stderr: result.stderr
+    };
+}
+function statusRank(status) {
+    return status === "fail" ? 2 : status === "warn" ? 1 : 0;
+}
+export function worstReadinessStatus(statuses) {
+    return statuses.reduce((worst, current)=>statusRank(current) > statusRank(worst) ? current : worst, "pass");
+}
+export function displayHome(target, homeDir) {
+    return target === homeDir ? "~" : target.startsWith(`${homeDir}/`) ? `~${target.slice(homeDir.length)}` : target;
+}
+export function record(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+export function nonEmpty(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+export async function accessible(target, runtime, mode = constants.R_OK) {
+    try {
+        await runtime.access(target, mode);
+        return true;
+    } catch  {
+        return false;
+    }
+}
+async function resolveExecutable(command, runtime) {
+    const candidates = runtime.path.split(delimiter).filter(Boolean).map((directory)=>join(directory, command));
+    const checks = await Promise.all(candidates.map(async (target)=>({
+            target,
+            available: await accessible(target, runtime, constants.X_OK)
+        })));
+    return checks.find((check)=>check.available)?.target ?? null;
+}
+export async function executableCheck(agent, runtime) {
+    const command = HARNESS_RUNTIME_PROFILES[agent].command;
+    const resolvedPath = await resolveExecutable(command, runtime);
+    return {
+        command,
+        path: resolvedPath,
+        status: resolvedPath ? "pass" : "fail",
+        errors: resolvedPath ? [] : [
+            `${command} was not found on PATH`
+        ]
+    };
+}
+export async function directoryCheck(configDir, runtime) {
+    const target = join(runtime.homeDir, configDir);
+    const readable = await accessible(target, runtime);
+    return {
+        path: displayHome(target, runtime.homeDir),
+        present: readable,
+        readable,
+        status: readable ? "pass" : "fail",
+        errors: readable ? [] : [
+            "global configuration directory is unavailable"
+        ]
+    };
+}
+export async function builtInSkillsCheck(agent, runtime) {
+    const relativeRoot = runtime.skillRoots[agent];
+    if (!relativeRoot) {
+        return {
+            path: null,
+            required: runtime.builtInSkillNames.length,
+            present: 0,
+            missing: [
+                ...runtime.builtInSkillNames
+            ],
+            status: "info",
+            errors: []
+        };
+    }
+    const root = join(runtime.homeDir, relativeRoot);
+    const checks = await Promise.all(runtime.builtInSkillNames.map(async (name)=>({
+            name,
+            present: await accessible(join(root, name, "SKILL.md"), runtime)
+        })));
+    const present = checks.filter((check)=>check.present).map((check)=>check.name);
+    const missing = runtime.builtInSkillNames.filter((name)=>!present.includes(name));
+    return {
+        path: displayHome(root, runtime.homeDir),
+        required: runtime.builtInSkillNames.length,
+        present: present.length,
+        missing: [
+            ...missing
+        ],
+        status: "info",
+        errors: []
+    };
+}
+export async function scriptCheck(installed, bundled, runtime) {
+    let installedText;
+    try {
+        installedText = await runtime.readFile(installed);
+    } catch  {
+        return {
+            path: displayHome(installed, runtime.homeDir),
+            present: false,
+            readable: false,
+            matchesBundledAsset: false,
+            status: "fail",
+            errors: [
+                "hook script is unavailable"
+            ]
+        };
+    }
+    try {
+        const bundledText = await runtime.readFile(bundled);
+        const matches = installedText === bundledText;
+        return {
+            path: displayHome(installed, runtime.homeDir),
+            present: true,
+            readable: true,
+            matchesBundledAsset: matches,
+            status: matches ? "pass" : "fail",
+            errors: matches ? [] : [
+                "hook script differs from the bundled AI DevKit asset"
+            ]
+        };
+    } catch  {
+        return {
+            path: displayHome(installed, runtime.homeDir),
+            present: true,
+            readable: true,
+            matchesBundledAsset: false,
+            status: "fail",
+            errors: [
+                "bundled hook asset is unavailable"
+            ]
+        };
+    }
+}
+function containsHook(root, event, command) {
+    const hooks = record(record(root)?.hooks);
+    const entries = hooks?.[event];
+    if (!Array.isArray(entries)) return false;
+    return entries.some((entry)=>{
+        const commands = record(entry)?.hooks;
+        return Array.isArray(commands) && commands.some((hook)=>{
+            const item = record(hook);
+            return item?.type === "command" && item.command === command;
+        });
+    });
+}
+export async function registrationCheck(target, event, command, runtime) {
+    try {
+        const parsed = JSON.parse(await runtime.readFile(target));
+        const valid = containsHook(parsed, event, command);
+        return {
+            path: displayHome(target, runtime.homeDir),
+            event,
+            command,
+            present: true,
+            valid,
+            status: valid ? "pass" : "fail",
+            errors: valid ? [] : [
+                "required hook registration is missing"
+            ]
+        };
+    } catch  {
+        return {
+            path: displayHome(target, runtime.homeDir),
+            event,
+            command,
+            present: false,
+            valid: false,
+            status: "fail",
+            errors: [
+                "hook configuration is missing or invalid"
+            ]
+        };
+    }
+}
+export async function mappingCheck(target, runtime) {
+    let text;
+    try {
+        text = await runtime.readFile(target);
+    } catch  {
+        return {
+            path: displayHome(target, runtime.homeDir),
+            present: false,
+            valid: false,
+            invalidEntries: 0,
+            staleEntries: 0,
+            status: "warn",
+            errors: [
+                "session mapping has not been created"
+            ]
+        };
+    }
+    let parsed = null;
+    try {
+        parsed = record(JSON.parse(text));
+    } catch  {
+    // Fixed safe error below.
+    }
+    if (!parsed) {
+        return {
+            path: displayHome(target, runtime.homeDir),
+            present: true,
+            valid: false,
+            invalidEntries: 0,
+            staleEntries: 0,
+            status: "fail",
+            errors: [
+                "session mapping is invalid"
+            ]
+        };
+    }
+    const entries = await Promise.all(Object.entries(parsed).map(async ([pid, sessionPath])=>{
+        if (!/^\d+$/.test(pid) || typeof sessionPath !== "string" || !sessionPath) {
+            return {
+                valid: false,
+                stale: false
+            };
+        }
+        return {
+            valid: true,
+            stale: !await accessible(sessionPath, runtime)
+        };
+    }));
+    const invalidEntries = entries.filter((entry)=>!entry.valid).length;
+    const staleEntries = entries.filter((entry)=>entry.stale).length;
+    const valid = invalidEntries === 0;
+    return {
+        path: displayHome(target, runtime.homeDir),
+        present: true,
+        valid,
+        invalidEntries,
+        staleEntries,
+        status: !valid ? "fail" : staleEntries ? "warn" : "pass",
+        errors: !valid ? [
+            "session mapping contains invalid entries"
+        ] : staleEntries ? [
+            "session mapping contains stale entries"
+        ] : []
+    };
+}
+
+//# sourceMappingURL=checks.js.map