@ghx-dev/core 0.1.1 → 0.2.0

package/dist/chunk-SCIJMW5P.js

@@ -1,54 +0,0 @@
-import {
-  getOperationCard,
-  listOperationCards
-} from "./chunk-OL4ARD3R.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)
-  };
-}
-
-// src/agent-interface/tools/list-capabilities-tool.ts
-function listCapabilities() {
-  return listOperationCards().map((card) => ({
-    capability_id: card.capability_id,
-    description: card.description
-  }));
-}
-
-export {
-  explainCapability,
-  listCapabilities
-};
-//# sourceMappingURL=chunk-SCIJMW5P.js.map

package/dist/chunk-SCIJMW5P.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/agent-interface/tools/explain-tool.ts","../src/agent-interface/tools/list-capabilities-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","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":";;;;;;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;;;AC5CO,SAAS,mBAAyC;AACvD,SAAO,mBAAmB,EAAE,IAAI,CAAC,UAAU;AAAA,IACzC,eAAe,KAAK;AAAA,IACpB,aAAa,KAAK;AAAA,EACpB,EAAE;AACJ;","names":[]}

package/dist/cli/assets/skills/ghx/SKILL.md

@@ -1,57 +0,0 @@
-# ghx CLI Skill
-
-Use `ghx` as the default interface for supported GitHub operations.
-
-## Session Bootstrap (run once)
-
-```bash
-gh auth status
-ghx capabilities list
-```
-
-If authentication fails, stop and request authentication before continuing.
-
-## Workflow
-
-1. Choose a capability from `ghx capabilities list`.
-2. If required inputs are unclear, inspect the capability:
-
-```bash
-ghx capabilities explain <capability_id>
-```
-
-3. Execute with structured JSON input:
-
-```bash
-ghx run <capability_id> --input '<json>'
-```
-
-## Result Handling Rules
-
-`ghx run` returns a result envelope: `{ ok, data, error, meta }`.
-
-- Check `ok` first.
-- If `ok=true`, use `data`.
-- If `ok=false`, read `error.code` and `error.message`.
-- If `error.retryable=true`, retry once.
-- For supported operations, do not parse raw `gh` output.
-
-## Input Conventions
-
-- Repository identity is `owner` + `name`.
-- Do not guess input fields; run `ghx capabilities explain <capability_id>`.
-
-## Examples
-
-```bash
-ghx run repo.view --input '{"owner":"octocat","name":"hello-world"}'
-ghx run issue.create --input '{"owner":"octocat","name":"hello-world","title":"Bug report","body":"Steps to reproduce"}'
-ghx run pr.view --input '{"owner":"octocat","name":"hello-world","prNumber":42}'
-ghx run pr.checks.get_failed --input '{"owner":"octocat","name":"hello-world","prNumber":42}'
-```
-
-## Guardrails
-
-- Prefer `ghx` over direct `gh` or API calls for supported operations.
-- Treat `meta.route_used` as informational only.
-- If a required input is unknown, ask the user instead of guessing.

package/dist/core/registry/cards/check_run.annotations.list.yaml

@@ -1,35 +0,0 @@
-capability_id: check_run.annotations.list
-version: "1.0.0"
-description: List annotations for one check run.
-input_schema:
-  type: object
-  required: [owner, name, checkRunId]
-  properties:
-    owner: { type: string, minLength: 1 }
-    name: { type: string, minLength: 1 }
-    checkRunId: { type: integer, minimum: 1 }
-  additionalProperties: false
-output_schema:
-  type: object
-  required: [items]
-  properties:
-    items:
-      type: array
-      items:
-        type: object
-        required: [path, startLine, endLine, level, message, title, details]
-        properties:
-          path: { type: [string, "null"] }
-          startLine: { type: [integer, "null"] }
-          endLine: { type: [integer, "null"] }
-          level: { type: [string, "null"] }
-          message: { type: [string, "null"] }
-          title: { type: [string, "null"] }
-          details: { type: [string, "null"] }
-        additionalProperties: false
-  additionalProperties: false
-routing:
-  preferred: cli
-  fallbacks: []
-cli:
-  command: api

package/dist/core/registry/cards/issue.assignees.update.yaml

@@ -1,27 +0,0 @@
-capability_id: issue.assignees.update
-version: "1.0.0"
-description: Replace issue assignees.
-input_schema:
-  type: object
-  required: [issueId, assignees]
-  properties:
-    issueId: { type: string, minLength: 1 }
-    assignees:
-      type: array
-      items: { type: string, minLength: 1 }
-  additionalProperties: false
-output_schema:
-  type: object
-  required: [id, assignees]
-  properties:
-    id: { type: string, minLength: 1 }
-    assignees:
-      type: array
-      items: { type: string, minLength: 1 }
-  additionalProperties: false
-routing:
-  preferred: graphql
-  fallbacks: []
-graphql:
-  operationName: IssueAssigneesUpdate
-  documentPath: src/gql/operations/issue-assignees-update.graphql

package/dist/core/registry/cards/issue.labels.update.yaml

@@ -1,27 +0,0 @@
-capability_id: issue.labels.update
-version: "1.0.0"
-description: Replace issue labels.
-input_schema:
-  type: object
-  required: [issueId, labels]
-  properties:
-    issueId: { type: string, minLength: 1 }
-    labels:
-      type: array
-      items: { type: string, minLength: 1 }
-  additionalProperties: false
-output_schema:
-  type: object
-  required: [id, labels]
-  properties:
-    id: { type: string, minLength: 1 }
-    labels:
-      type: array
-      items: { type: string, minLength: 1 }
-  additionalProperties: false
-routing:
-  preferred: graphql
-  fallbacks: []
-graphql:
-  operationName: IssueLabelsUpdate
-  documentPath: src/gql/operations/issue-labels-update.graphql

package/dist/core/registry/cards/pr.assignees.update.yaml

@@ -1,38 +0,0 @@
-capability_id: pr.assignees.update
-version: "1.0.0"
-description: Update pull request assignees.
-input_schema:
-  type: object
-  required: [owner, name, prNumber]
-  properties:
-    owner: { type: string, minLength: 1 }
-    name: { type: string, minLength: 1 }
-    prNumber: { type: integer, minimum: 1 }
-    add:
-      type: array
-      items: { type: string, minLength: 1 }
-    remove:
-      type: array
-      items: { type: string, minLength: 1 }
-  anyOf:
-    - required: [add]
-    - required: [remove]
-  additionalProperties: false
-output_schema:
-  type: object
-  required: [prNumber, add, remove, updated]
-  properties:
-    prNumber: { type: integer, minimum: 1 }
-    add:
-      type: array
-      items: { type: string, minLength: 1 }
-    remove:
-      type: array
-      items: { type: string, minLength: 1 }
-    updated: { type: boolean }
-  additionalProperties: false
-routing:
-  preferred: cli
-  fallbacks: []
-cli:
-  command: pr edit

package/dist/core/registry/cards/pr.checks.get_failed.yaml

@@ -1,42 +0,0 @@
-capability_id: pr.checks.get_failed
-version: "1.0.0"
-description: List failed pull request checks.
-input_schema:
-  type: object
-  required: [owner, name, prNumber]
-  properties:
-    owner: { type: string, minLength: 1 }
-    name: { type: string, minLength: 1 }
-    prNumber: { type: integer, minimum: 1 }
-  additionalProperties: false
-output_schema:
-  type: object
-  required: [items, summary]
-  properties:
-    items:
-      type: array
-      items:
-        type: object
-        required: [name, state, workflow, link]
-        properties:
-          name: { type: [string, "null"] }
-          state: { type: [string, "null"] }
-          workflow: { type: [string, "null"] }
-          link: { type: [string, "null"] }
-        additionalProperties: false
-    summary:
-      type: object
-      required: [total, failed, pending, passed]
-      properties:
-        total: { type: integer, minimum: 0 }
-        failed: { type: integer, minimum: 0 }
-        pending: { type: integer, minimum: 0 }
-        passed: { type: integer, minimum: 0 }
-      additionalProperties: false
-  additionalProperties: false
-routing:
-  preferred: cli
-  fallbacks: []
-cli:
-  command: pr checks
-  jsonFields: [name, state, workflow, link]

package/dist/core/registry/cards/pr.review.submit_approve.yaml

@@ -1,26 +0,0 @@
-capability_id: pr.review.submit_approve
-version: "1.0.0"
-description: Submit an approving pull request review.
-input_schema:
-  type: object
-  required: [owner, name, prNumber]
-  properties:
-    owner: { type: string, minLength: 1 }
-    name: { type: string, minLength: 1 }
-    prNumber: { type: integer, minimum: 1 }
-    body: { type: string, minLength: 1 }
-  additionalProperties: false
-output_schema:
-  type: object
-  required: [prNumber, event, submitted, body]
-  properties:
-    prNumber: { type: integer, minimum: 1 }
-    event: { type: string, const: APPROVE }
-    submitted: { type: boolean }
-    body: { type: [string, "null"] }
-  additionalProperties: false
-routing:
-  preferred: cli
-  fallbacks: []
-cli:
-  command: pr review

package/dist/core/registry/cards/pr.review.submit_comment.yaml

@@ -1,26 +0,0 @@
-capability_id: pr.review.submit_comment
-version: "1.0.0"
-description: Submit a comment-only pull request review.
-input_schema:
-  type: object
-  required: [owner, name, prNumber, body]
-  properties:
-    owner: { type: string, minLength: 1 }
-    name: { type: string, minLength: 1 }
-    prNumber: { type: integer, minimum: 1 }
-    body: { type: string, minLength: 1 }
-  additionalProperties: false
-output_schema:
-  type: object
-  required: [prNumber, event, submitted, body]
-  properties:
-    prNumber: { type: integer, minimum: 1 }
-    event: { type: string, const: COMMENT }
-    submitted: { type: boolean }
-    body: { type: string, minLength: 1 }
-  additionalProperties: false
-routing:
-  preferred: cli
-  fallbacks: []
-cli:
-  command: pr review

package/dist/core/registry/cards/pr.review.submit_request_changes.yaml

@@ -1,26 +0,0 @@
-capability_id: pr.review.submit_request_changes
-version: "1.0.0"
-description: Submit a pull request review requesting changes.
-input_schema:
-  type: object
-  required: [owner, name, prNumber, body]
-  properties:
-    owner: { type: string, minLength: 1 }
-    name: { type: string, minLength: 1 }
-    prNumber: { type: integer, minimum: 1 }
-    body: { type: string, minLength: 1 }
-  additionalProperties: false
-output_schema:
-  type: object
-  required: [prNumber, event, submitted, body]
-  properties:
-    prNumber: { type: integer, minimum: 1 }
-    event: { type: string, const: REQUEST_CHANGES }
-    submitted: { type: boolean }
-    body: { type: string, minLength: 1 }
-  additionalProperties: false
-routing:
-  preferred: cli
-  fallbacks: []
-cli:
-  command: pr review

package/dist/core/registry/cards/workflow_run.jobs.list.yaml

@@ -1,35 +0,0 @@
-capability_id: workflow_run.jobs.list
-version: "1.0.0"
-description: List jobs in a workflow run.
-input_schema:
-  type: object
-  required: [owner, name, runId]
-  properties:
-    owner: { type: string, minLength: 1 }
-    name: { type: string, minLength: 1 }
-    runId: { type: integer, minimum: 1 }
-  additionalProperties: false
-output_schema:
-  type: object
-  required: [items]
-  properties:
-    items:
-      type: array
-      items:
-        type: object
-        required: [id, name, status, conclusion, startedAt, completedAt, url]
-        properties:
-          id: { type: integer, minimum: 0 }
-          name: { type: [string, "null"] }
-          status: { type: [string, "null"] }
-          conclusion: { type: [string, "null"] }
-          startedAt: { type: [string, "null"] }
-          completedAt: { type: [string, "null"] }
-          url: { type: [string, "null"] }
-        additionalProperties: false
-  additionalProperties: false
-routing:
-  preferred: cli
-  fallbacks: []
-cli:
-  command: run view

package/dist/envelope-BpF6MNCv.d.ts

@@ -1,55 +0,0 @@
-declare const errorCodes: {
-    readonly Auth: "AUTH";
-    readonly NotFound: "NOT_FOUND";
-    readonly Validation: "VALIDATION";
-    readonly RateLimit: "RATE_LIMIT";
-    readonly Network: "NETWORK";
-    readonly Server: "SERVER";
-    readonly AdapterUnsupported: "ADAPTER_UNSUPPORTED";
-    readonly Unknown: "UNKNOWN";
-};
-type ErrorCode = (typeof errorCodes)[keyof typeof errorCodes];
-
-declare const routeReasonCodes: readonly ["INPUT_VALIDATION", "OUTPUT_VALIDATION", "CARD_PREFERRED", "CARD_FALLBACK", "PREFLIGHT_FAILED", "ENV_CONSTRAINT", "CAPABILITY_LIMIT", "DEFAULT_POLICY"];
-type RouteReasonCode = (typeof routeReasonCodes)[number];
-
-type RouteSource = "cli" | "rest" | "graphql";
-interface ResultError {
-    code: ErrorCode;
-    message: string;
-    retryable: boolean;
-    details?: Record<string, unknown>;
-}
-interface AttemptMeta {
-    route: RouteSource;
-    status: "success" | "error" | "skipped";
-    error_code?: ErrorCode;
-    duration_ms?: number;
-}
-interface ResultMeta {
-    capability_id: string;
-    route_used?: RouteSource;
-    reason?: RouteReasonCode;
-    attempts?: AttemptMeta[];
-    pagination?: {
-        has_next_page?: boolean;
-        end_cursor?: string;
-        next?: unknown;
-    };
-    timings?: {
-        total_ms?: number;
-        adapter_ms?: number;
-    };
-    cost?: {
-        tokens_in?: number;
-        tokens_out?: number;
-    };
-}
-interface ResultEnvelope<TData = unknown> {
-    ok: boolean;
-    data?: TData;
-    error?: ResultError;
-    meta: ResultMeta;
-}
-
-export type { AttemptMeta as A, ResultEnvelope as R, RouteSource as a, RouteReasonCode as b, ResultError as c, ResultMeta as d };