@ghx-dev/core 0.1.0-beta.0

package/dist/chunk-3RJCF42N.js

@@ -0,0 +1,16 @@
+import {
+  listOperationCards
+} from "./chunk-MT4U5DYD.js";
+
+// src/agent-interface/tools/list-capabilities-tool.ts
+function listCapabilities() {
+  return listOperationCards().map((card) => ({
+    capability_id: card.capability_id,
+    description: card.description
+  }));
+}
+
+export {
+  listCapabilities
+};
+//# sourceMappingURL=chunk-3RJCF42N.js.map

package/dist/chunk-3RJCF42N.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agent-interface/tools/list-capabilities-tool.ts"],"sourcesContent":["import { listOperationCards } from \"../../core/registry/index.js\"\n\nexport type CapabilityListItem = {\n  capability_id: string\n  description: string\n}\n\nexport function listCapabilities(): CapabilityListItem[] {\n  return listOperationCards().map((card) => ({\n    capability_id: card.capability_id,\n    description: card.description\n  }))\n}\n"],"mappings":";;;;;AAOO,SAAS,mBAAyC;AACvD,SAAO,mBAAmB,EAAE,IAAI,CAAC,UAAU;AAAA,IACzC,eAAe,KAAK;AAAA,IACpB,aAAa,KAAK;AAAA,EACpB,EAAE;AACJ;","names":[]}

package/dist/chunk-573MDG3I.js

@@ -0,0 +1,18 @@
+import {
+  errorCodes
+} from "./chunk-UOJWOHRM.js";
+
+// src/core/errors/retryability.ts
+var retryableCodes = /* @__PURE__ */ new Set([
+  errorCodes.Network,
+  errorCodes.RateLimit,
+  errorCodes.Server
+]);
+function isRetryableErrorCode(code) {
+  return retryableCodes.has(code);
+}
+
+export {
+  isRetryableErrorCode
+};
+//# sourceMappingURL=chunk-573MDG3I.js.map

package/dist/chunk-573MDG3I.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/errors/retryability.ts"],"sourcesContent":["import { errorCodes } from \"./codes.js\"\n\nconst retryableCodes = new Set<string>([\n  errorCodes.Network,\n  errorCodes.RateLimit,\n  errorCodes.Server\n])\n\nexport function isRetryableErrorCode(code: string): boolean {\n  return retryableCodes.has(code)\n}\n"],"mappings":";;;;;AAEA,IAAM,iBAAiB,oBAAI,IAAY;AAAA,EACrC,WAAW;AAAA,EACX,WAAW;AAAA,EACX,WAAW;AACb,CAAC;AAEM,SAAS,qBAAqB,MAAuB;AAC1D,SAAO,eAAe,IAAI,IAAI;AAChC;","names":[]}

package/dist/chunk-5JRLVOF2.js

@@ -0,0 +1,50 @@
+// src/core/registry/schema-validator.ts
+import Ajv from "ajv";
+var ajv = new Ajv({
+  allErrors: true,
+  strict: false
+});
+var validatorCache = /* @__PURE__ */ new WeakMap();
+function mapAjvErrors(errors) {
+  if (!errors) {
+    return [];
+  }
+  return errors.map((error) => ({
+    instancePath: error.instancePath,
+    message: error.message ?? "schema validation failed",
+    keyword: error.keyword,
+    params: error.params
+  }));
+}
+function getValidator(schema) {
+  const cached = validatorCache.get(schema);
+  if (cached) {
+    return cached;
+  }
+  const validator = ajv.compile(schema);
+  validatorCache.set(schema, validator);
+  return validator;
+}
+function validate(schema, payload) {
+  const validator = getValidator(schema);
+  const ok = validator(payload);
+  if (ok) {
+    return { ok: true };
+  }
+  return {
+    ok: false,
+    errors: mapAjvErrors(validator.errors)
+  };
+}
+function validateInput(inputSchema, params) {
+  return validate(inputSchema, params);
+}
+function validateOutput(outputSchema, data) {
+  return validate(outputSchema, data);
+}
+
+export {
+  validateInput,
+  validateOutput
+};
+//# sourceMappingURL=chunk-5JRLVOF2.js.map

package/dist/chunk-5JRLVOF2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/registry/schema-validator.ts"],"sourcesContent":["import Ajv from \"ajv\"\nimport type { ErrorObject, ValidateFunction } from \"ajv\"\n\ntype SchemaValidationError = {\n  instancePath: string\n  message: string\n  keyword: string\n  params: Record<string, unknown>\n}\n\ntype SchemaValidationResult =\n  | { ok: true }\n  | {\n      ok: false\n      errors: SchemaValidationError[]\n    }\n\nconst ajv = new Ajv({\n  allErrors: true,\n  strict: false\n})\n\nconst validatorCache = new WeakMap<Record<string, unknown>, ValidateFunction>()\n\nfunction mapAjvErrors(errors: ErrorObject[] | null | undefined): SchemaValidationError[] {\n  if (!errors) {\n    return []\n  }\n\n  return errors.map((error) => ({\n    instancePath: error.instancePath,\n    message: error.message ?? \"schema validation failed\",\n    keyword: error.keyword,\n    params: error.params\n  }))\n}\n\nfunction getValidator(schema: Record<string, unknown>): ValidateFunction {\n  const cached = validatorCache.get(schema)\n  if (cached) {\n    return cached\n  }\n\n  const validator = ajv.compile(schema)\n  validatorCache.set(schema, validator)\n  return validator\n}\n\nfunction validate(schema: Record<string, unknown>, payload: unknown): SchemaValidationResult {\n  const validator = getValidator(schema)\n  const ok = validator(payload)\n\n  if (ok) {\n    return { ok: true }\n  }\n\n  return {\n    ok: false,\n    errors: mapAjvErrors(validator.errors)\n  }\n}\n\nexport function validateInput(inputSchema: Record<string, unknown>, params: Record<string, unknown>): SchemaValidationResult {\n  return validate(inputSchema, params)\n}\n\nexport function validateOutput(outputSchema: Record<string, unknown>, data: unknown): SchemaValidationResult {\n  return validate(outputSchema, data)\n}\n"],"mappings":";AAAA,OAAO,SAAS;AAiBhB,IAAM,MAAM,IAAI,IAAI;AAAA,EAClB,WAAW;AAAA,EACX,QAAQ;AACV,CAAC;AAED,IAAM,iBAAiB,oBAAI,QAAmD;AAE9E,SAAS,aAAa,QAAmE;AACvF,MAAI,CAAC,QAAQ;AACX,WAAO,CAAC;AAAA,EACV;AAEA,SAAO,OAAO,IAAI,CAAC,WAAW;AAAA,IAC5B,cAAc,MAAM;AAAA,IACpB,SAAS,MAAM,WAAW;AAAA,IAC1B,SAAS,MAAM;AAAA,IACf,QAAQ,MAAM;AAAA,EAChB,EAAE;AACJ;AAEA,SAAS,aAAa,QAAmD;AACvE,QAAM,SAAS,eAAe,IAAI,MAAM;AACxC,MAAI,QAAQ;AACV,WAAO;AAAA,EACT;AAEA,QAAM,YAAY,IAAI,QAAQ,MAAM;AACpC,iBAAe,IAAI,QAAQ,SAAS;AACpC,SAAO;AACT;AAEA,SAAS,SAAS,QAAiC,SAA0C;AAC3F,QAAM,YAAY,aAAa,MAAM;AACrC,QAAM,KAAK,UAAU,OAAO;AAE5B,MAAI,IAAI;AACN,WAAO,EAAE,IAAI,KAAK;AAAA,EACpB;AAEA,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,QAAQ,aAAa,UAAU,MAAM;AAAA,EACvC;AACF;AAEO,SAAS,cAAc,aAAsC,QAAyD;AAC3H,SAAO,SAAS,aAAa,MAAM;AACrC;AAEO,SAAS,eAAe,cAAuC,MAAuC;AAC3G,SAAO,SAAS,cAAc,IAAI;AACpC;","names":[]}

package/dist/chunk-B6RLMKS4.js

@@ -0,0 +1,41 @@
+import {
+  errorCodes
+} from "./chunk-UOJWOHRM.js";
+
+// src/core/errors/map-error.ts
+function toMessage(error) {
+  if (error instanceof Error) {
+    return error.message;
+  }
+  return String(error);
+}
+function mapErrorToCode(error) {
+  const message = toMessage(error).toLowerCase();
+  if (message.includes("rate limit") || message.includes(" 429") || message.includes("too many requests")) {
+    return errorCodes.RateLimit;
+  }
+  if (message.includes("timeout")) {
+    return errorCodes.Network;
+  }
+  if (message.includes("econn") || message.includes("enotfound") || message.includes("eai_again") || message.includes("network") || message.includes("connection reset")) {
+    return errorCodes.Network;
+  }
+  if (message.includes(" 500") || message.includes(" 502") || message.includes(" 503") || message.includes(" 504")) {
+    return errorCodes.Server;
+  }
+  if (message.includes("auth") || message.includes("forbidden") || message.includes("unauthorized")) {
+    return errorCodes.Auth;
+  }
+  if (message.includes("validation") || message.includes("invalid") || message.includes("required") || message.includes("positive integer")) {
+    return errorCodes.Validation;
+  }
+  if (message.includes("not found") || message.includes(" 404")) {
+    return errorCodes.NotFound;
+  }
+  return errorCodes.Unknown;
+}
+
+export {
+  mapErrorToCode
+};
+//# sourceMappingURL=chunk-B6RLMKS4.js.map

package/dist/chunk-B6RLMKS4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/errors/map-error.ts"],"sourcesContent":["import { errorCodes } from \"./codes.js\"\nimport type { ErrorCode } from \"./codes.js\"\n\nfunction toMessage(error: unknown): string {\n  if (error instanceof Error) {\n    return error.message\n  }\n\n  return String(error)\n}\n\nexport function mapErrorToCode(error: unknown): ErrorCode {\n  const message = toMessage(error).toLowerCase()\n\n  if (message.includes(\"rate limit\") || message.includes(\" 429\") || message.includes(\"too many requests\")) {\n    return errorCodes.RateLimit\n  }\n\n  if (message.includes(\"timeout\")) {\n    return errorCodes.Network\n  }\n\n  if (\n    message.includes(\"econn\") ||\n    message.includes(\"enotfound\") ||\n    message.includes(\"eai_again\") ||\n    message.includes(\"network\") ||\n    message.includes(\"connection reset\")\n  ) {\n    return errorCodes.Network\n  }\n\n  if (message.includes(\" 500\") || message.includes(\" 502\") || message.includes(\" 503\") || message.includes(\" 504\")) {\n    return errorCodes.Server\n  }\n\n  if (message.includes(\"auth\") || message.includes(\"forbidden\") || message.includes(\"unauthorized\")) {\n    return errorCodes.Auth\n  }\n\n  if (\n    message.includes(\"validation\") ||\n    message.includes(\"invalid\") ||\n    message.includes(\"required\") ||\n    message.includes(\"positive integer\")\n  ) {\n    return errorCodes.Validation\n  }\n\n  if (message.includes(\"not found\") || message.includes(\" 404\")) {\n    return errorCodes.NotFound\n  }\n\n  return errorCodes.Unknown\n}\n"],"mappings":";;;;;AAGA,SAAS,UAAU,OAAwB;AACzC,MAAI,iBAAiB,OAAO;AAC1B,WAAO,MAAM;AAAA,EACf;AAEA,SAAO,OAAO,KAAK;AACrB;AAEO,SAAS,eAAe,OAA2B;AACxD,QAAM,UAAU,UAAU,KAAK,EAAE,YAAY;AAE7C,MAAI,QAAQ,SAAS,YAAY,KAAK,QAAQ,SAAS,MAAM,KAAK,QAAQ,SAAS,mBAAmB,GAAG;AACvG,WAAO,WAAW;AAAA,EACpB;AAEA,MAAI,QAAQ,SAAS,SAAS,GAAG;AAC/B,WAAO,WAAW;AAAA,EACpB;AAEA,MACE,QAAQ,SAAS,OAAO,KACxB,QAAQ,SAAS,WAAW,KAC5B,QAAQ,SAAS,WAAW,KAC5B,QAAQ,SAAS,SAAS,KAC1B,QAAQ,SAAS,kBAAkB,GACnC;AACA,WAAO,WAAW;AAAA,EACpB;AAEA,MAAI,QAAQ,SAAS,MAAM,KAAK,QAAQ,SAAS,MAAM,KAAK,QAAQ,SAAS,MAAM,KAAK,QAAQ,SAAS,MAAM,GAAG;AAChH,WAAO,WAAW;AAAA,EACpB;AAEA,MAAI,QAAQ,SAAS,MAAM,KAAK,QAAQ,SAAS,WAAW,KAAK,QAAQ,SAAS,cAAc,GAAG;AACjG,WAAO,WAAW;AAAA,EACpB;AAEA,MACE,QAAQ,SAAS,YAAY,KAC7B,QAAQ,SAAS,SAAS,KAC1B,QAAQ,SAAS,UAAU,KAC3B,QAAQ,SAAS,kBAAkB,GACnC;AACA,WAAO,WAAW;AAAA,EACpB;AAEA,MAAI,QAAQ,SAAS,WAAW,KAAK,QAAQ,SAAS,MAAM,GAAG;AAC7D,WAAO,WAAW;AAAA,EACpB;AAEA,SAAO,WAAW;AACpB;","names":[]}

package/dist/chunk-BJHVAFTN.js

@@ -0,0 +1,42 @@
+import {
+  explainCapability
+} from "./chunk-MMG6CIKK.js";
+
+// src/cli/commands/capabilities-explain.ts
+function usage() {
+  return "Usage: ghx capabilities explain <capability_id> [--json]";
+}
+function parseArgs(argv) {
+  const asJson = argv.includes("--json");
+  const capabilityId = argv.find((arg) => !arg.startsWith("-"));
+  return { capabilityId, asJson };
+}
+async function capabilitiesExplainCommand(argv = []) {
+  const { capabilityId, asJson } = parseArgs(argv);
+  if (!capabilityId) {
+    process.stderr.write(`${usage()}
+`);
+    return 1;
+  }
+  try {
+    const explained = explainCapability(capabilityId);
+    if (asJson) {
+      process.stdout.write(`${JSON.stringify(explained)}
+`);
+      return 0;
+    }
+    process.stdout.write(`${JSON.stringify(explained, null, 2)}
+`);
+    return 0;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    process.stderr.write(`${message}
+`);
+    return 1;
+  }
+}
+
+export {
+  capabilitiesExplainCommand
+};
+//# sourceMappingURL=chunk-BJHVAFTN.js.map

package/dist/chunk-BJHVAFTN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/commands/capabilities-explain.ts"],"sourcesContent":["import { explainCapability } from \"../../agent-interface/tools/explain-tool.js\"\n\nfunction usage(): string {\n  return \"Usage: ghx capabilities explain <capability_id> [--json]\"\n}\n\nfunction parseArgs(argv: string[]): { capabilityId: string | undefined; asJson: boolean } {\n  const asJson = argv.includes(\"--json\")\n  const capabilityId = argv.find((arg) => !arg.startsWith(\"-\"))\n  return { capabilityId, asJson }\n}\n\nexport async function capabilitiesExplainCommand(argv: string[] = []): Promise<number> {\n  const { capabilityId, asJson } = parseArgs(argv)\n\n  if (!capabilityId) {\n    process.stderr.write(`${usage()}\\n`)\n    return 1\n  }\n\n  try {\n    const explained = explainCapability(capabilityId)\n\n    if (asJson) {\n      process.stdout.write(`${JSON.stringify(explained)}\\n`)\n      return 0\n    }\n\n    process.stdout.write(`${JSON.stringify(explained, null, 2)}\\n`)\n    return 0\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error)\n    process.stderr.write(`${message}\\n`)\n    return 1\n  }\n}\n"],"mappings":";;;;;AAEA,SAAS,QAAgB;AACvB,SAAO;AACT;AAEA,SAAS,UAAU,MAAuE;AACxF,QAAM,SAAS,KAAK,SAAS,QAAQ;AACrC,QAAM,eAAe,KAAK,KAAK,CAAC,QAAQ,CAAC,IAAI,WAAW,GAAG,CAAC;AAC5D,SAAO,EAAE,cAAc,OAAO;AAChC;AAEA,eAAsB,2BAA2B,OAAiB,CAAC,GAAoB;AACrF,QAAM,EAAE,cAAc,OAAO,IAAI,UAAU,IAAI;AAE/C,MAAI,CAAC,cAAc;AACjB,YAAQ,OAAO,MAAM,GAAG,MAAM,CAAC;AAAA,CAAI;AACnC,WAAO;AAAA,EACT;AAEA,MAAI;AACF,UAAM,YAAY,kBAAkB,YAAY;AAEhD,QAAI,QAAQ;AACV,cAAQ,OAAO,MAAM,GAAG,KAAK,UAAU,SAAS,CAAC;AAAA,CAAI;AACrD,aAAO;AAAA,IACT;AAEA,YAAQ,OAAO,MAAM,GAAG,KAAK,UAAU,WAAW,MAAM,CAAC,CAAC;AAAA,CAAI;AAC9D,WAAO;AAAA,EACT,SAAS,OAAO;AACd,UAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACrE,YAAQ,OAAO,MAAM,GAAG,OAAO;AAAA,CAAI;AACnC,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/chunk-D746VR3B.js

@@ -0,0 +1,38 @@
+// src/gql/operations/issue-list.generated.ts
+var IssueListDocument = `
+    query IssueList($owner: String!, $name: String!, $first: Int!, $after: String) {
+  repository(owner: $owner, name: $name) {
+    issues(
+      first: $first
+      after: $after
+      orderBy: {field: CREATED_AT, direction: DESC}
+    ) {
+      nodes {
+        id
+        number
+        title
+        state
+        url
+      }
+      pageInfo {
+        endCursor
+        hasNextPage
+      }
+    }
+  }
+}
+    `;
+var defaultWrapper = (action, _operationName, _operationType, _variables) => action();
+function getSdk(client, withWrapper = defaultWrapper) {
+  return {
+    IssueList(variables, requestHeaders, signal) {
+      return withWrapper((wrappedRequestHeaders) => client.request({ document: IssueListDocument, variables, requestHeaders: { ...requestHeaders, ...wrappedRequestHeaders }, signal }), "IssueList", "query", variables);
+    }
+  };
+}
+
+export {
+  IssueListDocument,
+  getSdk
+};
+//# sourceMappingURL=chunk-D746VR3B.js.map

package/dist/chunk-D746VR3B.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/gql/operations/issue-list.generated.ts"],"sourcesContent":["import type * as Types from '../generated/common-types';\n\nimport type { GraphQLClient, RequestOptions } from 'graphql-request';\ntype GraphQLClientRequestHeaders = RequestOptions['requestHeaders'];\nexport type IssueListQueryVariables = Types.Exact<{\n  owner: Types.Scalars['String']['input'];\n  name: Types.Scalars['String']['input'];\n  first: Types.Scalars['Int']['input'];\n  after?: Types.InputMaybe<Types.Scalars['String']['input']>;\n}>;\n\n\nexport type IssueListQuery = { __typename?: 'Query', repository?: { __typename?: 'Repository', issues: { __typename?: 'IssueConnection', nodes?: Array<{ __typename?: 'Issue', id: string, number: number, title: string, state: Types.IssueState, url: any } | null> | null, pageInfo: { __typename?: 'PageInfo', endCursor?: string | null, hasNextPage: boolean } } } | null };\n\n\nexport const IssueListDocument = `\n    query IssueList($owner: String!, $name: String!, $first: Int!, $after: String) {\n  repository(owner: $owner, name: $name) {\n    issues(\n      first: $first\n      after: $after\n      orderBy: {field: CREATED_AT, direction: DESC}\n    ) {\n      nodes {\n        id\n        number\n        title\n        state\n        url\n      }\n      pageInfo {\n        endCursor\n        hasNextPage\n      }\n    }\n  }\n}\n    `;\n\nexport type SdkFunctionWrapper = <T>(action: (requestHeaders?:Record<string, string>) => Promise<T>, operationName: string, operationType?: string, variables?: any) => Promise<T>;\n\n\nconst defaultWrapper: SdkFunctionWrapper = (action, _operationName, _operationType, _variables) => action();\n\nexport function getSdk(client: GraphQLClient, withWrapper: SdkFunctionWrapper = defaultWrapper) {\n  return {\n    IssueList(variables: IssueListQueryVariables, requestHeaders?: GraphQLClientRequestHeaders, signal?: RequestInit['signal']): Promise<IssueListQuery> {\n      return withWrapper((wrappedRequestHeaders) => client.request<IssueListQuery>({ document: IssueListDocument, variables, requestHeaders: { ...requestHeaders, ...wrappedRequestHeaders }, signal }), 'IssueList', 'query', variables);\n    }\n  };\n}\nexport type Sdk = ReturnType<typeof getSdk>;"],"mappings":";AAeO,IAAM,oBAAoB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA2BjC,IAAM,iBAAqC,CAAC,QAAQ,gBAAgB,gBAAgB,eAAe,OAAO;AAEnG,SAAS,OAAO,QAAuB,cAAkC,gBAAgB;AAC9F,SAAO;AAAA,IACL,UAAU,WAAoC,gBAA8C,QAAyD;AACnJ,aAAO,YAAY,CAAC,0BAA0B,OAAO,QAAwB,EAAE,UAAU,mBAAmB,WAAW,gBAAgB,EAAE,GAAG,gBAAgB,GAAG,sBAAsB,GAAG,OAAO,CAAC,GAAG,aAAa,SAAS,SAAS;AAAA,IACpO;AAAA,EACF;AACF;","names":[]}

package/dist/chunk-DJIEG6K7.js

@@ -0,0 +1,20 @@
+// src/agent-interface/tools/execute-tool.ts
+function createExecuteTool(deps) {
+  return {
+    execute(capabilityId, params, options) {
+      const request = {
+        task: capabilityId,
+        input: params,
+        ...options ? { options } : {}
+      };
+      return deps.executeTask({
+        ...request
+      });
+    }
+  };
+}
+
+export {
+  createExecuteTool
+};
+//# sourceMappingURL=chunk-DJIEG6K7.js.map

package/dist/chunk-DJIEG6K7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agent-interface/tools/execute-tool.ts"],"sourcesContent":["import type { ResultEnvelope } from \"../../core/contracts/envelope.js\"\n\ntype ExecuteTaskFn = (request: {\n  task: string\n  input: Record<string, unknown>\n  options?: Record<string, unknown>\n}) => Promise<ResultEnvelope>\n\nexport function createExecuteTool(deps: { executeTask: ExecuteTaskFn }) {\n  return {\n    execute(\n      capabilityId: string,\n      params: Record<string, unknown>,\n      options?: Record<string, unknown>\n    ): Promise<ResultEnvelope> {\n      const request = {\n        task: capabilityId,\n        input: params,\n        ...(options ? { options } : {})\n      }\n\n      return deps.executeTask({\n        ...request\n      })\n    }\n  }\n}\n"],"mappings":";AAQO,SAAS,kBAAkB,MAAsC;AACtE,SAAO;AAAA,IACL,QACE,cACA,QACA,SACyB;AACzB,YAAM,UAAU;AAAA,QACd,MAAM;AAAA,QACN,OAAO;AAAA,QACP,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;AAAA,MAC/B;AAEA,aAAO,KAAK,YAAY;AAAA,QACtB,GAAG;AAAA,MACL,CAAC;AAAA,IACH;AAAA,EACF;AACF;","names":[]}

package/dist/chunk-DLKIQBK6.js

@@ -0,0 +1,106 @@
+// src/core/execution/cli/safe-runner.ts
+import { spawn } from "child_process";
+var DEFAULT_MAX_OUTPUT_BYTES = 1e6;
+function createSafeCliCommandRunner(options) {
+  const maxOutputBytes = options?.maxOutputBytes ?? DEFAULT_MAX_OUTPUT_BYTES;
+  return {
+    run(command, args, timeoutMs) {
+      if (timeoutMs <= 0) {
+        return Promise.reject(new Error("timeoutMs must be a positive number"));
+      }
+      return new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+          shell: false,
+          stdio: ["ignore", "pipe", "pipe"]
+        });
+        const stdoutChunks = [];
+        const stderrChunks = [];
+        let stdoutSize = 0;
+        let stderrSize = 0;
+        let failureReason = null;
+        let settled = false;
+        const timer = setTimeout(() => {
+          if (failureReason === null) {
+            failureReason = "timeout";
+          }
+          child.kill("SIGKILL");
+        }, timeoutMs);
+        function settleError(error) {
+          if (settled) {
+            return;
+          }
+          settled = true;
+          clearTimeout(timer);
+          reject(error);
+        }
+        function settleSuccess(stdout, stderr, exitCode) {
+          if (settled) {
+            return;
+          }
+          settled = true;
+          clearTimeout(timer);
+          resolve({ stdout, stderr, exitCode });
+        }
+        child.stdout?.on("data", (chunk) => {
+          if (failureReason === "overflow") {
+            return;
+          }
+          stdoutSize += chunk.length;
+          if (stdoutSize + stderrSize > maxOutputBytes) {
+            if (failureReason === null) {
+              failureReason = "overflow";
+              clearTimeout(timer);
+              child.kill("SIGKILL");
+              settleError(new Error(`CLI output exceeded ${maxOutputBytes} bytes`));
+              return;
+            }
+            child.kill("SIGKILL");
+            return;
+          }
+          stdoutChunks.push(chunk);
+        });
+        child.stderr?.on("data", (chunk) => {
+          if (failureReason === "overflow") {
+            return;
+          }
+          stderrSize += chunk.length;
+          if (stdoutSize + stderrSize > maxOutputBytes) {
+            if (failureReason === null) {
+              failureReason = "overflow";
+              clearTimeout(timer);
+              child.kill("SIGKILL");
+              settleError(new Error(`CLI output exceeded ${maxOutputBytes} bytes`));
+              return;
+            }
+            child.kill("SIGKILL");
+            return;
+          }
+          stderrChunks.push(chunk);
+        });
+        child.on("error", (error) => {
+          settleError(error);
+        });
+        child.on("close", (code) => {
+          if (failureReason === "timeout") {
+            settleError(new Error(`CLI command timed out after ${timeoutMs}ms`));
+            return;
+          }
+          if (failureReason === "overflow") {
+            settleError(new Error(`CLI output exceeded ${maxOutputBytes} bytes`));
+            return;
+          }
+          settleSuccess(
+            Buffer.concat(stdoutChunks).toString("utf8"),
+            Buffer.concat(stderrChunks).toString("utf8"),
+            code ?? 1
+          );
+        });
+      });
+    }
+  };
+}
+
+export {
+  createSafeCliCommandRunner
+};
+//# sourceMappingURL=chunk-DLKIQBK6.js.map

package/dist/chunk-DLKIQBK6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/execution/cli/safe-runner.ts"],"sourcesContent":["import { spawn } from \"node:child_process\"\n\nimport type { CliCommandRunner } from \"../adapters/cli-capability-adapter.js\"\n\nconst DEFAULT_MAX_OUTPUT_BYTES = 1_000_000\n\ntype SafeRunnerOptions = {\n  maxOutputBytes?: number\n}\n\nexport function createSafeCliCommandRunner(options?: SafeRunnerOptions): CliCommandRunner {\n  const maxOutputBytes = options?.maxOutputBytes ?? DEFAULT_MAX_OUTPUT_BYTES\n\n  return {\n    run(command: string, args: string[], timeoutMs: number): Promise<{ stdout: string; stderr: string; exitCode: number }> {\n      if (timeoutMs <= 0) {\n        return Promise.reject(new Error(\"timeoutMs must be a positive number\"))\n      }\n\n      return new Promise((resolve, reject) => {\n        const child = spawn(command, args, {\n          shell: false,\n          stdio: [\"ignore\", \"pipe\", \"pipe\"]\n        })\n\n        const stdoutChunks: Buffer[] = []\n        const stderrChunks: Buffer[] = []\n        let stdoutSize = 0\n        let stderrSize = 0\n        let failureReason: \"timeout\" | \"overflow\" | null = null\n        let settled = false\n\n        const timer = setTimeout(() => {\n          if (failureReason === null) {\n            failureReason = \"timeout\"\n          }\n          child.kill(\"SIGKILL\")\n        }, timeoutMs)\n\n        function settleError(error: Error): void {\n          if (settled) {\n            return\n          }\n\n          settled = true\n          clearTimeout(timer)\n          reject(error)\n        }\n\n        function settleSuccess(stdout: string, stderr: string, exitCode: number): void {\n          if (settled) {\n            return\n          }\n\n          settled = true\n          clearTimeout(timer)\n          resolve({ stdout, stderr, exitCode })\n        }\n\n        child.stdout?.on(\"data\", (chunk: Buffer) => {\n          if (failureReason === \"overflow\") {\n            return\n          }\n\n          stdoutSize += chunk.length\n          if (stdoutSize + stderrSize > maxOutputBytes) {\n            if (failureReason === null) {\n              failureReason = \"overflow\"\n              clearTimeout(timer)\n              child.kill(\"SIGKILL\")\n              settleError(new Error(`CLI output exceeded ${maxOutputBytes} bytes`))\n              return\n            }\n\n            child.kill(\"SIGKILL\")\n            return\n          }\n\n          stdoutChunks.push(chunk)\n        })\n\n        child.stderr?.on(\"data\", (chunk: Buffer) => {\n          if (failureReason === \"overflow\") {\n            return\n          }\n\n          stderrSize += chunk.length\n          if (stdoutSize + stderrSize > maxOutputBytes) {\n            if (failureReason === null) {\n              failureReason = \"overflow\"\n              clearTimeout(timer)\n              child.kill(\"SIGKILL\")\n              settleError(new Error(`CLI output exceeded ${maxOutputBytes} bytes`))\n              return\n            }\n\n            child.kill(\"SIGKILL\")\n            return\n          }\n\n          stderrChunks.push(chunk)\n        })\n\n        child.on(\"error\", (error) => {\n          settleError(error)\n        })\n\n        child.on(\"close\", (code) => {\n          if (failureReason === \"timeout\") {\n            settleError(new Error(`CLI command timed out after ${timeoutMs}ms`))\n            return\n          }\n\n          if (failureReason === \"overflow\") {\n            settleError(new Error(`CLI output exceeded ${maxOutputBytes} bytes`))\n            return\n          }\n\n          settleSuccess(\n            Buffer.concat(stdoutChunks).toString(\"utf8\"),\n            Buffer.concat(stderrChunks).toString(\"utf8\"),\n            code ?? 1\n          )\n        })\n      })\n    }\n  }\n}\n"],"mappings":";AAAA,SAAS,aAAa;AAItB,IAAM,2BAA2B;AAM1B,SAAS,2BAA2B,SAA+C;AACxF,QAAM,iBAAiB,SAAS,kBAAkB;AAElD,SAAO;AAAA,IACL,IAAI,SAAiB,MAAgB,WAAkF;AACrH,UAAI,aAAa,GAAG;AAClB,eAAO,QAAQ,OAAO,IAAI,MAAM,qCAAqC,CAAC;AAAA,MACxE;AAEA,aAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,cAAM,QAAQ,MAAM,SAAS,MAAM;AAAA,UACjC,OAAO;AAAA,UACP,OAAO,CAAC,UAAU,QAAQ,MAAM;AAAA,QAClC,CAAC;AAED,cAAM,eAAyB,CAAC;AAChC,cAAM,eAAyB,CAAC;AAChC,YAAI,aAAa;AACjB,YAAI,aAAa;AACjB,YAAI,gBAA+C;AACnD,YAAI,UAAU;AAEd,cAAM,QAAQ,WAAW,MAAM;AAC7B,cAAI,kBAAkB,MAAM;AAC1B,4BAAgB;AAAA,UAClB;AACA,gBAAM,KAAK,SAAS;AAAA,QACtB,GAAG,SAAS;AAEZ,iBAAS,YAAY,OAAoB;AACvC,cAAI,SAAS;AACX;AAAA,UACF;AAEA,oBAAU;AACV,uBAAa,KAAK;AAClB,iBAAO,KAAK;AAAA,QACd;AAEA,iBAAS,cAAc,QAAgB,QAAgB,UAAwB;AAC7E,cAAI,SAAS;AACX;AAAA,UACF;AAEA,oBAAU;AACV,uBAAa,KAAK;AAClB,kBAAQ,EAAE,QAAQ,QAAQ,SAAS,CAAC;AAAA,QACtC;AAEA,cAAM,QAAQ,GAAG,QAAQ,CAAC,UAAkB;AAC1C,cAAI,kBAAkB,YAAY;AAChC;AAAA,UACF;AAEA,wBAAc,MAAM;AACpB,cAAI,aAAa,aAAa,gBAAgB;AAC5C,gBAAI,kBAAkB,MAAM;AAC1B,8BAAgB;AAChB,2BAAa,KAAK;AAClB,oBAAM,KAAK,SAAS;AACpB,0BAAY,IAAI,MAAM,uBAAuB,cAAc,QAAQ,CAAC;AACpE;AAAA,YACF;AAEA,kBAAM,KAAK,SAAS;AACpB;AAAA,UACF;AAEA,uBAAa,KAAK,KAAK;AAAA,QACzB,CAAC;AAED,cAAM,QAAQ,GAAG,QAAQ,CAAC,UAAkB;AAC1C,cAAI,kBAAkB,YAAY;AAChC;AAAA,UACF;AAEA,wBAAc,MAAM;AACpB,cAAI,aAAa,aAAa,gBAAgB;AAC5C,gBAAI,kBAAkB,MAAM;AAC1B,8BAAgB;AAChB,2BAAa,KAAK;AAClB,oBAAM,KAAK,SAAS;AACpB,0BAAY,IAAI,MAAM,uBAAuB,cAAc,QAAQ,CAAC;AACpE;AAAA,YACF;AAEA,kBAAM,KAAK,SAAS;AACpB;AAAA,UACF;AAEA,uBAAa,KAAK,KAAK;AAAA,QACzB,CAAC;AAED,cAAM,GAAG,SAAS,CAAC,UAAU;AAC3B,sBAAY,KAAK;AAAA,QACnB,CAAC;AAED,cAAM,GAAG,SAAS,CAAC,SAAS;AAC1B,cAAI,kBAAkB,WAAW;AAC/B,wBAAY,IAAI,MAAM,+BAA+B,SAAS,IAAI,CAAC;AACnE;AAAA,UACF;AAEA,cAAI,kBAAkB,YAAY;AAChC,wBAAY,IAAI,MAAM,uBAAuB,cAAc,QAAQ,CAAC;AACpE;AAAA,UACF;AAEA;AAAA,YACE,OAAO,OAAO,YAAY,EAAE,SAAS,MAAM;AAAA,YAC3C,OAAO,OAAO,YAAY,EAAE,SAAS,MAAM;AAAA,YAC3C,QAAQ;AAAA,UACV;AAAA,QACF,CAAC;AAAA,MACH,CAAC;AAAA,IACH;AAAA,EACF;AACF;","names":[]}

package/dist/chunk-EBRDO4Y6.js

@@ -0,0 +1,31 @@
+// src/gql/operations/repo-view.generated.ts
+var RepoViewDocument = `
+    query RepoView($owner: String!, $name: String!) {
+  repository(owner: $owner, name: $name) {
+    id
+    name
+    nameWithOwner
+    isPrivate
+    stargazerCount
+    forkCount
+    url
+    defaultBranchRef {
+      name
+    }
+  }
+}
+    `;
+var defaultWrapper = (action, _operationName, _operationType, _variables) => action();
+function getSdk(client, withWrapper = defaultWrapper) {
+  return {
+    RepoView(variables, requestHeaders, signal) {
+      return withWrapper((wrappedRequestHeaders) => client.request({ document: RepoViewDocument, variables, requestHeaders: { ...requestHeaders, ...wrappedRequestHeaders }, signal }), "RepoView", "query", variables);
+    }
+  };
+}
+
+export {
+  RepoViewDocument,
+  getSdk
+};
+//# sourceMappingURL=chunk-EBRDO4Y6.js.map

package/dist/chunk-EBRDO4Y6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/gql/operations/repo-view.generated.ts"],"sourcesContent":["import type * as Types from '../generated/common-types';\n\nimport type { GraphQLClient, RequestOptions } from 'graphql-request';\ntype GraphQLClientRequestHeaders = RequestOptions['requestHeaders'];\nexport type RepoViewQueryVariables = Types.Exact<{\n  owner: Types.Scalars['String']['input'];\n  name: Types.Scalars['String']['input'];\n}>;\n\n\nexport type RepoViewQuery = { __typename?: 'Query', repository?: { __typename?: 'Repository', id: string, name: string, nameWithOwner: string, isPrivate: boolean, stargazerCount: number, forkCount: number, url: any, defaultBranchRef?: { __typename?: 'Ref', name: string } | null } | null };\n\n\nexport const RepoViewDocument = `\n    query RepoView($owner: String!, $name: String!) {\n  repository(owner: $owner, name: $name) {\n    id\n    name\n    nameWithOwner\n    isPrivate\n    stargazerCount\n    forkCount\n    url\n    defaultBranchRef {\n      name\n    }\n  }\n}\n    `;\n\nexport type SdkFunctionWrapper = <T>(action: (requestHeaders?:Record<string, string>) => Promise<T>, operationName: string, operationType?: string, variables?: any) => Promise<T>;\n\n\nconst defaultWrapper: SdkFunctionWrapper = (action, _operationName, _operationType, _variables) => action();\n\nexport function getSdk(client: GraphQLClient, withWrapper: SdkFunctionWrapper = defaultWrapper) {\n  return {\n    RepoView(variables: RepoViewQueryVariables, requestHeaders?: GraphQLClientRequestHeaders, signal?: RequestInit['signal']): Promise<RepoViewQuery> {\n      return withWrapper((wrappedRequestHeaders) => client.request<RepoViewQuery>({ document: RepoViewDocument, variables, requestHeaders: { ...requestHeaders, ...wrappedRequestHeaders }, signal }), 'RepoView', 'query', variables);\n    }\n  };\n}\nexport type Sdk = ReturnType<typeof getSdk>;"],"mappings":";AAaO,IAAM,mBAAmB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAoBhC,IAAM,iBAAqC,CAAC,QAAQ,gBAAgB,gBAAgB,eAAe,OAAO;AAEnG,SAAS,OAAO,QAAuB,cAAkC,gBAAgB;AAC9F,SAAO;AAAA,IACL,SAAS,WAAmC,gBAA8C,QAAwD;AAChJ,aAAO,YAAY,CAAC,0BAA0B,OAAO,QAAuB,EAAE,UAAU,kBAAkB,WAAW,gBAAgB,EAAE,GAAG,gBAAgB,GAAG,sBAAsB,GAAG,OAAO,CAAC,GAAG,YAAY,SAAS,SAAS;AAAA,IACjO;AAAA,EACF;AACF;","names":[]}

package/dist/chunk-FXN6IIT5.js

@@ -0,0 +1,14 @@
+// src/agent-interface/prompt/main-skill.ts
+var MAIN_SKILL_TEXT = `
+Use execute(capability_id, params) for all GitHub actions.
+Never call gh help and never fetch GraphQL schema/introspection.
+If required params are unknown, call explain(capability_id) or ask the user.
+Treat ResultEnvelope.ok=false as a failure.
+If error.retryable=true, retry once unless user requested otherwise.
+Only reason about ResultEnvelope.data and ResultEnvelope.error.
+`.trim();
+
+export {
+  MAIN_SKILL_TEXT
+};
+//# sourceMappingURL=chunk-FXN6IIT5.js.map

package/dist/chunk-FXN6IIT5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agent-interface/prompt/main-skill.ts"],"sourcesContent":["export const MAIN_SKILL_TEXT = `\nUse execute(capability_id, params) for all GitHub actions.\nNever call gh help and never fetch GraphQL schema/introspection.\nIf required params are unknown, call explain(capability_id) or ask the user.\nTreat ResultEnvelope.ok=false as a failure.\nIf error.retryable=true, retry once unless user requested otherwise.\nOnly reason about ResultEnvelope.data and ResultEnvelope.error.\n`.trim()\n"],"mappings":";AAAO,IAAM,kBAAkB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO7B,KAAK;","names":[]}

package/dist/chunk-GPU4P7UG.js

@@ -0,0 +1,92 @@
+import {
+  executeTask
+} from "./chunk-WYSY75U7.js";
+import {
+  createGithubClient
+} from "./chunk-YQDQX4BT.js";
+
+// src/cli/commands/run.ts
+var GITHUB_GRAPHQL_ENDPOINT = "https://api.github.com/graphql";
+function parseRunArgs(argv) {
+  const [task, ...rest] = argv;
+  if (!task || task.trim().length === 0) {
+    throw new Error("Usage: ghx run <task> --input '<json>'");
+  }
+  const inputIndex = rest.findIndex((arg) => arg === "--input");
+  const inlineInput = rest.find((arg) => arg.startsWith("--input="));
+  const inputRaw = inputIndex >= 0 ? rest[inputIndex + 1] : inlineInput ? inlineInput.slice("--input=".length) : void 0;
+  if (!inputRaw) {
+    throw new Error("Missing --input JSON");
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(inputRaw);
+  } catch {
+    throw new Error("Invalid JSON for --input");
+  }
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+    throw new Error("--input must be a JSON object");
+  }
+  return { task, input: parsed };
+}
+function resolveGithubToken() {
+  const token = process.env.GITHUB_TOKEN ?? process.env.GH_TOKEN;
+  if (!token || token.trim().length === 0) {
+    throw new Error("Missing GITHUB_TOKEN or GH_TOKEN for GraphQL transport");
+  }
+  return token;
+}
+async function executeGraphqlRequest(token, query, variables) {
+  const response = await fetch(GITHUB_GRAPHQL_ENDPOINT, {
+    method: "POST",
+    headers: {
+      "content-type": "application/json",
+      accept: "application/json",
+      authorization: `Bearer ${token}`,
+      "user-agent": "ghx"
+    },
+    body: JSON.stringify({ query, variables: variables ?? {} })
+  });
+  const payload = await response.json();
+  if (!response.ok) {
+    const message = payload.message ?? `GitHub GraphQL request failed with status ${response.status}`;
+    throw new Error(message);
+  }
+  if (Array.isArray(payload.errors) && payload.errors.length > 0) {
+    const message = payload.errors[0]?.message ?? "GitHub GraphQL returned errors";
+    throw new Error(message);
+  }
+  if (payload.data === void 0) {
+    throw new Error("GitHub GraphQL response missing data");
+  }
+  return payload.data;
+}
+async function runCommand(argv = []) {
+  if (argv.length === 0) {
+    process.stdout.write("Usage: ghx run <task> --input '<json>'\n");
+    return 1;
+  }
+  const { task, input } = parseRunArgs(argv);
+  const githubToken = resolveGithubToken();
+  const githubClient = createGithubClient({
+    async execute(query, variables) {
+      return executeGraphqlRequest(githubToken, query, variables);
+    }
+  });
+  const request = {
+    task,
+    input
+  };
+  const result = await executeTask(request, {
+    githubClient,
+    githubToken
+  });
+  process.stdout.write(`${JSON.stringify(result)}
+`);
+  return 0;
+}
+
+export {
+  runCommand
+};
+//# sourceMappingURL=chunk-GPU4P7UG.js.map

package/dist/chunk-GPU4P7UG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/commands/run.ts"],"sourcesContent":["import { createGithubClient } from \"../../gql/client.js\"\nimport { executeTask } from \"../../core/routing/engine.js\"\nimport type { TaskRequest } from \"../../core/contracts/task.js\"\n\nconst GITHUB_GRAPHQL_ENDPOINT = \"https://api.github.com/graphql\"\n\nfunction parseRunArgs(argv: string[]): { task: string; input: Record<string, unknown> } {\n  const [task, ...rest] = argv\n  if (!task || task.trim().length === 0) {\n    throw new Error(\"Usage: ghx run <task> --input '<json>'\")\n  }\n\n  const inputIndex = rest.findIndex((arg) => arg === \"--input\")\n  const inlineInput = rest.find((arg) => arg.startsWith(\"--input=\"))\n  const inputRaw =\n    inputIndex >= 0\n      ? rest[inputIndex + 1]\n      : inlineInput\n        ? inlineInput.slice(\"--input=\".length)\n        : undefined\n\n  if (!inputRaw) {\n    throw new Error(\"Missing --input JSON\")\n  }\n\n  let parsed: unknown\n  try {\n    parsed = JSON.parse(inputRaw)\n  } catch {\n    throw new Error(\"Invalid JSON for --input\")\n  }\n\n  if (typeof parsed !== \"object\" || parsed === null || Array.isArray(parsed)) {\n    throw new Error(\"--input must be a JSON object\")\n  }\n\n  return { task, input: parsed as Record<string, unknown> }\n}\n\nfunction resolveGithubToken(): string {\n  const token = process.env.GITHUB_TOKEN ?? process.env.GH_TOKEN\n  if (!token || token.trim().length === 0) {\n    throw new Error(\"Missing GITHUB_TOKEN or GH_TOKEN for GraphQL transport\")\n  }\n\n  return token\n}\n\nasync function executeGraphqlRequest<TData>(\n  token: string,\n  query: string,\n  variables?: Record<string, unknown>\n): Promise<TData> {\n  const response = await fetch(GITHUB_GRAPHQL_ENDPOINT, {\n    method: \"POST\",\n    headers: {\n      \"content-type\": \"application/json\",\n      accept: \"application/json\",\n      authorization: `Bearer ${token}`,\n      \"user-agent\": \"ghx\"\n    },\n    body: JSON.stringify({ query, variables: variables ?? {} })\n  })\n\n  const payload = (await response.json()) as {\n    data?: TData\n    errors?: Array<{ message?: string }>\n    message?: string\n  }\n\n  if (!response.ok) {\n    const message = payload.message ?? `GitHub GraphQL request failed with status ${response.status}`\n    throw new Error(message)\n  }\n\n  if (Array.isArray(payload.errors) && payload.errors.length > 0) {\n    const message = payload.errors[0]?.message ?? \"GitHub GraphQL returned errors\"\n    throw new Error(message)\n  }\n\n  if (payload.data === undefined) {\n    throw new Error(\"GitHub GraphQL response missing data\")\n  }\n\n  return payload.data\n}\n\nexport async function runCommand(argv: string[] = []): Promise<number> {\n  if (argv.length === 0) {\n    process.stdout.write(\"Usage: ghx run <task> --input '<json>'\\n\")\n    return 1\n  }\n\n  const { task, input } = parseRunArgs(argv)\n  const githubToken = resolveGithubToken()\n\n  const githubClient = createGithubClient({\n    async execute<TData>(query: string, variables?: Record<string, unknown>): Promise<TData> {\n      return executeGraphqlRequest<TData>(githubToken, query, variables)\n    }\n  })\n\n  const request: TaskRequest = {\n    task,\n    input\n  }\n\n  const result = await executeTask(request, {\n    githubClient,\n    githubToken\n  })\n\n  process.stdout.write(`${JSON.stringify(result)}\\n`)\n  return 0\n}\n"],"mappings":";;;;;;;;AAIA,IAAM,0BAA0B;AAEhC,SAAS,aAAa,MAAkE;AACtF,QAAM,CAAC,MAAM,GAAG,IAAI,IAAI;AACxB,MAAI,CAAC,QAAQ,KAAK,KAAK,EAAE,WAAW,GAAG;AACrC,UAAM,IAAI,MAAM,wCAAwC;AAAA,EAC1D;AAEA,QAAM,aAAa,KAAK,UAAU,CAAC,QAAQ,QAAQ,SAAS;AAC5D,QAAM,cAAc,KAAK,KAAK,CAAC,QAAQ,IAAI,WAAW,UAAU,CAAC;AACjE,QAAM,WACJ,cAAc,IACV,KAAK,aAAa,CAAC,IACnB,cACE,YAAY,MAAM,WAAW,MAAM,IACnC;AAER,MAAI,CAAC,UAAU;AACb,UAAM,IAAI,MAAM,sBAAsB;AAAA,EACxC;AAEA,MAAI;AACJ,MAAI;AACF,aAAS,KAAK,MAAM,QAAQ;AAAA,EAC9B,QAAQ;AACN,UAAM,IAAI,MAAM,0BAA0B;AAAA,EAC5C;AAEA,MAAI,OAAO,WAAW,YAAY,WAAW,QAAQ,MAAM,QAAQ,MAAM,GAAG;AAC1E,UAAM,IAAI,MAAM,+BAA+B;AAAA,EACjD;AAEA,SAAO,EAAE,MAAM,OAAO,OAAkC;AAC1D;AAEA,SAAS,qBAA6B;AACpC,QAAM,QAAQ,QAAQ,IAAI,gBAAgB,QAAQ,IAAI;AACtD,MAAI,CAAC,SAAS,MAAM,KAAK,EAAE,WAAW,GAAG;AACvC,UAAM,IAAI,MAAM,wDAAwD;AAAA,EAC1E;AAEA,SAAO;AACT;AAEA,eAAe,sBACb,OACA,OACA,WACgB;AAChB,QAAM,WAAW,MAAM,MAAM,yBAAyB;AAAA,IACpD,QAAQ;AAAA,IACR,SAAS;AAAA,MACP,gBAAgB;AAAA,MAChB,QAAQ;AAAA,MACR,eAAe,UAAU,KAAK;AAAA,MAC9B,cAAc;AAAA,IAChB;AAAA,IACA,MAAM,KAAK,UAAU,EAAE,OAAO,WAAW,aAAa,CAAC,EAAE,CAAC;AAAA,EAC5D,CAAC;AAED,QAAM,UAAW,MAAM,SAAS,KAAK;AAMrC,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,UAAU,QAAQ,WAAW,6CAA6C,SAAS,MAAM;AAC/F,UAAM,IAAI,MAAM,OAAO;AAAA,EACzB;AAEA,MAAI,MAAM,QAAQ,QAAQ,MAAM,KAAK,QAAQ,OAAO,SAAS,GAAG;AAC9D,UAAM,UAAU,QAAQ,OAAO,CAAC,GAAG,WAAW;AAC9C,UAAM,IAAI,MAAM,OAAO;AAAA,EACzB;AAEA,MAAI,QAAQ,SAAS,QAAW;AAC9B,UAAM,IAAI,MAAM,sCAAsC;AAAA,EACxD;AAEA,SAAO,QAAQ;AACjB;AAEA,eAAsB,WAAW,OAAiB,CAAC,GAAoB;AACrE,MAAI,KAAK,WAAW,GAAG;AACrB,YAAQ,OAAO,MAAM,0CAA0C;AAC/D,WAAO;AAAA,EACT;AAEA,QAAM,EAAE,MAAM,MAAM,IAAI,aAAa,IAAI;AACzC,QAAM,cAAc,mBAAmB;AAEvC,QAAM,eAAe,mBAAmB;AAAA,IACtC,MAAM,QAAe,OAAe,WAAqD;AACvF,aAAO,sBAA6B,aAAa,OAAO,SAAS;AAAA,IACnE;AAAA,EACF,CAAC;AAED,QAAM,UAAuB;AAAA,IAC3B;AAAA,IACA;AAAA,EACF;AAEA,QAAM,SAAS,MAAM,YAAY,SAAS;AAAA,IACxC;AAAA,IACA;AAAA,EACF,CAAC;AAED,UAAQ,OAAO,MAAM,GAAG,KAAK,UAAU,MAAM,CAAC;AAAA,CAAI;AAClD,SAAO;AACT;","names":[]}

package/dist/chunk-MMG6CIKK.js

@@ -0,0 +1,44 @@
+import {
+  getOperationCard
+} from "./chunk-MT4U5DYD.js";
+
+// src/agent-interface/tools/explain-tool.ts
+function extractRequiredInputs(inputSchema) {
+  if (!inputSchema || typeof inputSchema !== "object") {
+    return [];
+  }
+  const required = inputSchema.required;
+  if (!Array.isArray(required)) {
+    return [];
+  }
+  return required.filter((entry) => typeof entry === "string");
+}
+function extractOutputFields(outputSchema) {
+  if (!outputSchema || typeof outputSchema !== "object") {
+    return [];
+  }
+  const properties = outputSchema.properties;
+  if (!properties || typeof properties !== "object") {
+    return [];
+  }
+  return Object.keys(properties);
+}
+function explainCapability(capabilityId) {
+  const card = getOperationCard(capabilityId);
+  if (!card) {
+    throw new Error(`Unknown capability: ${capabilityId}`);
+  }
+  return {
+    capability_id: card.capability_id,
+    purpose: card.description,
+    required_inputs: extractRequiredInputs(card.input_schema),
+    preferred_route: card.routing.preferred,
+    fallback_routes: [...card.routing.fallbacks],
+    output_fields: extractOutputFields(card.output_schema)
+  };
+}
+
+export {
+  explainCapability
+};
+//# sourceMappingURL=chunk-MMG6CIKK.js.map

package/dist/chunk-MMG6CIKK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agent-interface/tools/explain-tool.ts"],"sourcesContent":["import { getOperationCard } from \"../../core/registry/index.js\"\n\nexport type CapabilityExplanation = {\n  capability_id: string\n  purpose: string\n  required_inputs: string[]\n  preferred_route: \"cli\" | \"graphql\" | \"rest\"\n  fallback_routes: Array<\"cli\" | \"graphql\" | \"rest\">\n  output_fields: string[]\n}\n\nfunction extractRequiredInputs(inputSchema: Record<string, unknown> | null | undefined): string[] {\n  if (!inputSchema || typeof inputSchema !== \"object\") {\n    return []\n  }\n\n  const required = (inputSchema as Record<string, unknown>).required\n  if (!Array.isArray(required)) {\n    return []\n  }\n\n  return required.filter((entry): entry is string => typeof entry === \"string\")\n}\n\nfunction extractOutputFields(outputSchema: Record<string, unknown> | null | undefined): string[] {\n  if (!outputSchema || typeof outputSchema !== \"object\") {\n    return []\n  }\n\n  const properties = (outputSchema as Record<string, unknown>).properties\n  if (!properties || typeof properties !== \"object\") {\n    return []\n  }\n\n  return Object.keys(properties)\n}\n\nexport function explainCapability(capabilityId: string): CapabilityExplanation {\n  const card = getOperationCard(capabilityId)\n  if (!card) {\n    throw new Error(`Unknown capability: ${capabilityId}`)\n  }\n\n  return {\n    capability_id: card.capability_id,\n    purpose: card.description,\n    required_inputs: extractRequiredInputs(card.input_schema),\n    preferred_route: card.routing.preferred,\n    fallback_routes: [...card.routing.fallbacks],\n    output_fields: extractOutputFields(card.output_schema)\n  }\n}\n"],"mappings":";;;;;AAWA,SAAS,sBAAsB,aAAmE;AAChG,MAAI,CAAC,eAAe,OAAO,gBAAgB,UAAU;AACnD,WAAO,CAAC;AAAA,EACV;AAEA,QAAM,WAAY,YAAwC;AAC1D,MAAI,CAAC,MAAM,QAAQ,QAAQ,GAAG;AAC5B,WAAO,CAAC;AAAA,EACV;AAEA,SAAO,SAAS,OAAO,CAAC,UAA2B,OAAO,UAAU,QAAQ;AAC9E;AAEA,SAAS,oBAAoB,cAAoE;AAC/F,MAAI,CAAC,gBAAgB,OAAO,iBAAiB,UAAU;AACrD,WAAO,CAAC;AAAA,EACV;AAEA,QAAM,aAAc,aAAyC;AAC7D,MAAI,CAAC,cAAc,OAAO,eAAe,UAAU;AACjD,WAAO,CAAC;AAAA,EACV;AAEA,SAAO,OAAO,KAAK,UAAU;AAC/B;AAEO,SAAS,kBAAkB,cAA6C;AAC7E,QAAM,OAAO,iBAAiB,YAAY;AAC1C,MAAI,CAAC,MAAM;AACT,UAAM,IAAI,MAAM,uBAAuB,YAAY,EAAE;AAAA,EACvD;AAEA,SAAO;AAAA,IACL,eAAe,KAAK;AAAA,IACpB,SAAS,KAAK;AAAA,IACd,iBAAiB,sBAAsB,KAAK,YAAY;AAAA,IACxD,iBAAiB,KAAK,QAAQ;AAAA,IAC9B,iBAAiB,CAAC,GAAG,KAAK,QAAQ,SAAS;AAAA,IAC3C,eAAe,oBAAoB,KAAK,aAAa;AAAA,EACvD;AACF;","names":[]}