@weiyentan/opencode-plugin-awx 0.2.0 → 0.3.0

package/dist/contracts/job-detail.js

@@ -4,12 +4,6 @@
  * Canonical TypeScript representation of the `awx_job_detail.py` v1.0 output schema.
  * Every job-related tool MUST return output matching this contract.
  *
- * This file provides **both**:
- * - Zod schemas for runtime validation (e.g., API response parsing)
- * - Inferred TypeScript types for static type checking
- *
- * The contract has been verified against fixture snapshots in `tests/contracts/__snapshots__/`.
- *
  * ## Schema Fields
  *
  * - **schema_version**: Always "1.0"
@@ -27,72 +21,6 @@
  * - Use `derived` — NOT `extra_vars_summary`
  * - `related` fields are resolved names, not raw URLs
  * - `job.limit` is the AWX job limit (host pattern), not a pagination value
- *
- * ## Snapshot Testing
- *
- * Fixture JSON files in `tests/fixtures/` serve as contract snapshots.
- * When the Python `awx_job_detail.py` v1.0 output contract changes,
- * regenerate the fixtures (see README.md for instructions) and re-run
- * tests to verify schema compatibility.
- *
- * ## Regeneration
- *
- * To regenerate the contract snapshots after fixture changes:
- * ```bash
- * python3 scripts/generate-snapshots.py
- * ```
  */
-import { z } from "zod";
-// ─── Sub-schemas ───────────────────────────────────────────
-export const JobCoreSchema = z.object({
-    id: z.number().int().positive(),
-    name: z.string(),
-    status: z.string(),
-    failed: z.boolean(),
-    job_type: z.string(),
-    playbook: z.string(),
-    created: z.string(),
-    started: z.string().nullable(),
-    finished: z.string().nullable(),
-    elapsed: z.number().nullable(),
-    execution_node: z.string(),
-    controller_node: z.string(),
-    scm_branch: z.string(),
-    verbosity: z.number().int().min(0),
-    forks: z.number().int().min(0).nullable(),
-    limit: z.string(),
-});
-export const RelatedSchema = z.object({
-    inventory_name: z.string(),
-    project_name: z.string(),
-    job_template_name: z.string(),
-    instance_group_name: z.string(),
-    created_by: z.string(),
-    credential_names: z.array(z.string()),
-    label_names: z.array(z.string()),
-});
-export const HostStatusCountsSchema = z.object({
-    ok: z.number().int().min(0),
-    failed: z.number().int().min(0),
-    skipped: z.number().int().min(0),
-    changed: z.number().int().min(0),
-    unreachable: z.number().int().min(0),
-});
-export const DerivedSchema = z.object({
-    is_successful: z.boolean(),
-    is_failed: z.boolean(),
-    has_unreachable_hosts: z.boolean(),
-});
-// ─── Top-level schema ──────────────────────────────────────
-export const JobDetailOutputSchema = z.object({
-    schema_version: z.literal("1.0"),
-    job: JobCoreSchema,
-    related: RelatedSchema,
-    host_status_counts: HostStatusCountsSchema,
-    derived: DerivedSchema,
-    warnings: z.array(z.string()),
-    errors: z.array(z.string()),
-    stdout: z.string().optional(),
-    raw_events: z.array(z.unknown()).optional(),
-});
+export {};
 //# sourceMappingURL=job-detail.js.map

package/dist/contracts/job-detail.js.map

@@ -1 +1 @@
-{"version":3,"file":"job-detail.js","sourceRoot":"","sources":["../../src/contracts/job-detail.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"job-detail.js","sourceRoot":"","sources":["../../src/contracts/job-detail.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG"}

package/dist/contracts/project-detail.d.ts

@@ -0,0 +1,58 @@
+/**
+ * AWX Project Detail Output Contract — v1.0
+ *
+ * TypeScript interface defining the structured output for project detail
+ * requests. Used by `mapProject()` to shape raw AWX API responses into
+ * the canonical format.
+ *
+ * ## Schema Fields
+ *
+ * - **schema_version**: Always "1.0"
+ * - **resource_type**: Always "project"
+ * - **id**: The numeric resource ID
+ * - **data**: Core project data with resolved related names and derived flags
+ *
+ * ## Field Naming Convention
+ *
+ * - Related resource names are resolved from `summary_fields` (not raw IDs)
+ * - `scm_type` is the SCM provider (e.g., "git", "svn", "")
+ * - `last_updated` may be null for never-updated projects
+ * - `created_by` is resolved from summary_fields.created_by.username
+ */
+export interface ProjectRelated {
+    organization_name: string;
+    created_by: string;
+}
+export interface ProjectDerived {
+    is_successful: boolean;
+    is_failed: boolean;
+}
+export interface ProjectData {
+    id: number;
+    name: string;
+    description: string;
+    scm_type: string;
+    scm_url: string;
+    scm_branch: string;
+    status: string;
+    last_updated: string | null;
+    created: string;
+    modified: string;
+    /** Resolved from summary_fields.organization.name */
+    organization_name: string;
+    /** Resolved from summary_fields.created_by.username */
+    created_by: string;
+    /** Whether the project is in a successful state */
+    is_successful: boolean;
+    /** Whether the project is in a failed state */
+    is_failed: boolean;
+    warnings: string[];
+    errors: string[];
+}
+export interface ProjectDetailOutput {
+    schema_version: "1.0";
+    resource_type: "project";
+    id: number;
+    data: ProjectData;
+}
+//# sourceMappingURL=project-detail.d.ts.map

package/dist/contracts/project-detail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-detail.d.ts","sourceRoot":"","sources":["../../src/contracts/project-detail.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,MAAM,WAAW,cAAc;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,aAAa,EAAE,OAAO,CAAC;IACvB,+CAA+C;IAC/C,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAID,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,KAAK,CAAC;IACtB,aAAa,EAAE,SAAS,CAAC;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;CACnB"}

package/dist/contracts/project-detail.js

@@ -0,0 +1,23 @@
+/**
+ * AWX Project Detail Output Contract — v1.0
+ *
+ * TypeScript interface defining the structured output for project detail
+ * requests. Used by `mapProject()` to shape raw AWX API responses into
+ * the canonical format.
+ *
+ * ## Schema Fields
+ *
+ * - **schema_version**: Always "1.0"
+ * - **resource_type**: Always "project"
+ * - **id**: The numeric resource ID
+ * - **data**: Core project data with resolved related names and derived flags
+ *
+ * ## Field Naming Convention
+ *
+ * - Related resource names are resolved from `summary_fields` (not raw IDs)
+ * - `scm_type` is the SCM provider (e.g., "git", "svn", "")
+ * - `last_updated` may be null for never-updated projects
+ * - `created_by` is resolved from summary_fields.created_by.username
+ */
+export {};
+//# sourceMappingURL=project-detail.js.map

package/dist/contracts/project-detail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-detail.js","sourceRoot":"","sources":["../../src/contracts/project-detail.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG"}

package/dist/contracts/sync-project.d.ts

@@ -2,9 +2,6 @@
  * Sync Project Output Contract
  *
  * Canonical schema for the `awx-sync-project` tool's return value.
- * Defines both:
- * - Zod schema for runtime validation
- * - Inferred TypeScript types for static type checking
  *
  * ## Schema Fields
  *
@@ -16,16 +13,14 @@
  * - **scm_type**: SCM type (e.g., "git", "svn")
  * - **last_updated**: Timestamp of last project update
  */
-import { z } from "zod";
-export declare const ProjectSyncOutputSchema: z.ZodObject<{
-    project_update_id: z.ZodNumber;
-    status: z.ZodString;
-    project_name: z.ZodString;
-    project_id: z.ZodNumber;
-    url: z.ZodString;
-    scm_type: z.ZodString;
-    last_updated: z.ZodString;
-}, z.core.$strip>;
 /** Structured output returned by the awx-sync-project tool */
-export type ProjectSyncOutput = z.infer<typeof ProjectSyncOutputSchema>;
+export interface ProjectSyncOutput {
+    project_update_id: number;
+    status: string;
+    project_name: string;
+    project_id: number;
+    url: string;
+    scm_type: string;
+    last_updated: string;
+}
 //# sourceMappingURL=sync-project.d.ts.map

package/dist/contracts/sync-project.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync-project.d.ts","sourceRoot":"","sources":["../../src/contracts/sync-project.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,uBAAuB;;;;;;;;iBAQlC,CAAC;AAIH,8DAA8D;AAC9D,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}
+{"version":3,"file":"sync-project.d.ts","sourceRoot":"","sources":["../../src/contracts/sync-project.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,8DAA8D;AAC9D,MAAM,WAAW,iBAAiB;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/contracts/sync-project.js

@@ -2,9 +2,6 @@
  * Sync Project Output Contract
  *
  * Canonical schema for the `awx-sync-project` tool's return value.
- * Defines both:
- * - Zod schema for runtime validation
- * - Inferred TypeScript types for static type checking
  *
  * ## Schema Fields
  *
@@ -16,15 +13,5 @@
  * - **scm_type**: SCM type (e.g., "git", "svn")
  * - **last_updated**: Timestamp of last project update
  */
-import { z } from "zod";
-// ─── Top-level schema ──────────────────────────────────────
-export const ProjectSyncOutputSchema = z.object({
-    project_update_id: z.number().int().positive(),
-    status: z.string(),
-    project_name: z.string(),
-    project_id: z.number().int().positive(),
-    url: z.string(),
-    scm_type: z.string(),
-    last_updated: z.string(),
-});
+export {};
 //# sourceMappingURL=sync-project.js.map

package/dist/contracts/sync-project.js.map

@@ -1 +1 @@
-{"version":3,"file":"sync-project.js","sourceRoot":"","sources":["../../src/contracts/sync-project.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8DAA8D;AAE9D,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAC9C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACvC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;CACzB,CAAC,CAAC"}
+{"version":3,"file":"sync-project.js","sourceRoot":"","sources":["../../src/contracts/sync-project.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}

package/dist/contracts/template-detail.d.ts

@@ -0,0 +1,55 @@
+/**
+ * AWX Template Detail Output Contract — v1.0
+ *
+ * TypeScript interface defining the structured output for job template
+ * detail requests. Used by `mapTemplate()` to shape raw AWX API responses
+ * into the canonical format.
+ *
+ * ## Schema Fields
+ *
+ * - **schema_version**: Always "1.0"
+ * - **resource_type**: Always "template"
+ * - **id**: The numeric resource ID
+ * - **data**: Core template data with resolved related names
+ *
+ * ## Field Naming Convention
+ *
+ * - Related resource names are resolved from `summary_fields` (not raw IDs)
+ * - `ask_*` fields are boolean launch-time prompts
+ * - `last_job_run` and `next_schedule` may be null
+ */
+export interface TemplateData {
+    id: number;
+    name: string;
+    description: string;
+    job_type: string;
+    /** Resolved from summary_fields.inventory.name */
+    inventory_name: string;
+    /** Resolved from summary_fields.project.name */
+    project_name: string;
+    /** Resolved from summary_fields.organization.name */
+    organization_name: string;
+    playbook: string;
+    verbosity: number;
+    /** Whether the template prompts for variables on launch */
+    ask_variables_on_launch: boolean;
+    /** Whether the template prompts for inventory on launch */
+    ask_inventory_on_launch: boolean;
+    /** Whether the template prompts for a host limit on launch */
+    ask_limit_on_launch: boolean;
+    /** ISO 8601 timestamp of the most recent job launch, or null */
+    last_job_run: string | null;
+    /** Current template status (e.g. "successful", "never updated") */
+    status: string;
+    /** Name of the next scheduled run, or null */
+    next_schedule: string | null;
+    /** Resolved label names from summary_fields.labels.results */
+    labels: string[];
+}
+export interface TemplateDetailOutput {
+    schema_version: "1.0";
+    resource_type: "template";
+    id: number;
+    data: TemplateData;
+}
+//# sourceMappingURL=template-detail.d.ts.map

package/dist/contracts/template-detail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-detail.d.ts","sourceRoot":"","sources":["../../src/contracts/template-detail.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,cAAc,EAAE,MAAM,CAAC;IACvB,gDAAgD;IAChD,YAAY,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,uBAAuB,EAAE,OAAO,CAAC;IACjC,2DAA2D;IAC3D,uBAAuB,EAAE,OAAO,CAAC;IACjC,8DAA8D;IAC9D,mBAAmB,EAAE,OAAO,CAAC;IAC7B,gEAAgE;IAChE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,8DAA8D;IAC9D,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAID,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAE,KAAK,CAAC;IACtB,aAAa,EAAE,UAAU,CAAC;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,CAAC;CACpB"}

package/dist/contracts/template-detail.js

@@ -0,0 +1,22 @@
+/**
+ * AWX Template Detail Output Contract — v1.0
+ *
+ * TypeScript interface defining the structured output for job template
+ * detail requests. Used by `mapTemplate()` to shape raw AWX API responses
+ * into the canonical format.
+ *
+ * ## Schema Fields
+ *
+ * - **schema_version**: Always "1.0"
+ * - **resource_type**: Always "template"
+ * - **id**: The numeric resource ID
+ * - **data**: Core template data with resolved related names
+ *
+ * ## Field Naming Convention
+ *
+ * - Related resource names are resolved from `summary_fields` (not raw IDs)
+ * - `ask_*` fields are boolean launch-time prompts
+ * - `last_job_run` and `next_schedule` may be null
+ */
+export {};
+//# sourceMappingURL=template-detail.js.map

package/dist/contracts/template-detail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-detail.js","sourceRoot":"","sources":["../../src/contracts/template-detail.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG"}

package/dist/get-resource.d.ts

@@ -0,0 +1,49 @@
+/**
+ * get-resource.ts — AWX Resource Detail Orchestrator
+ *
+ * Generalized individual resource detail getter. Maps { type, id } to
+ * an AWX API endpoint, fetches the resource, and delegates to a
+ * per-type mapper to produce the structured output envelope.
+ *
+ * ## Design
+ *
+ * - **Registry**: `RESOURCE_REGISTRY` maps type strings to AWX API
+ *   endpoints and mapper functions.
+ * - **Dispatch**: `getResource()` looks up the registry, fetches from
+ *   AWX, maps the response, and returns a typed output.
+ * - **Error handling**: Unknown types throw with a clear message.
+ *   Non-2xx API responses throw with status and body details.
+ *   Abort errors propagate through.
+ *
+ * ## Adding a new resource type
+ *
+ * 1. Define a contract in `contracts/<resource>-detail.ts`
+ * 2. Write a mapper in `mappers/map-<resource>.ts`
+ * 3. Register it in `RESOURCE_REGISTRY` below
+ * 4. Optionally add the type to the Zod schema in `index.ts`
+ */
+import type { AwxClient } from "./client.js";
+import type { TemplateDetailOutput } from "./contracts/template-detail.js";
+import type { ProjectDetailOutput } from "./contracts/project-detail.js";
+import type { InventoryDetailOutput } from "./contracts/inventory-detail.js";
+/**
+ * Union of all supported resource detail output types.
+ * Extend this when adding new resource types.
+ */
+export type ResourceDetailOutput = TemplateDetailOutput | ProjectDetailOutput | InventoryDetailOutput;
+/**
+ * Supported resource type keys (used by the tool args Zod schema).
+ */
+export type ResourceType = "template" | "project" | "inventory";
+/**
+ * Fetch and map a single AWX resource by type and ID.
+ *
+ * @param client       The AWX HTTP client
+ * @param type         Resource type (e.g., "template")
+ * @param id           Numeric resource ID
+ * @param abortSignal  Optional AbortSignal for cancellation
+ * @returns            Mapped resource output (e.g., TemplateDetailOutput)
+ * @throws             If type is unsupported or the API returns an error
+ */
+export declare function getResource(client: AwxClient, type: ResourceType, id: number, abortSignal?: AbortSignal): Promise<ResourceDetailOutput>;
+//# sourceMappingURL=get-resource.d.ts.map

package/dist/get-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-resource.d.ts","sourceRoot":"","sources":["../src/get-resource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAI7C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAE7E;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,GAAG,mBAAmB,GAAG,qBAAqB,CAAC;AAEtG;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,CAAC;AAkChE;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,YAAY,EAClB,EAAE,EAAE,MAAM,EACV,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,oBAAoB,CAAC,CA6B/B"}

package/dist/get-resource.js

@@ -0,0 +1,49 @@
+import { mapTemplate } from "./mappers/map-template.js";
+import { mapProject } from "./mappers/map-project.js";
+import { mapInventory } from "./mappers/map-inventory.js";
+/**
+ * Type→endpoint+mapper registry.
+ *
+ * Each entry maps a resource type string to:
+ * - `path`: AWX API endpoint with `{id}` placeholder
+ * - `mapper`: pure function that transforms the raw API response
+ */
+const RESOURCE_REGISTRY = {
+    template: {
+        path: "/api/v2/job_templates/{id}/",
+        mapper: mapTemplate,
+    },
+    project: {
+        path: "/api/v2/projects/{id}/",
+        mapper: mapProject,
+    },
+    inventory: {
+        path: "/api/v2/inventories/{id}/",
+        mapper: mapInventory,
+    },
+};
+/**
+ * Fetch and map a single AWX resource by type and ID.
+ *
+ * @param client       The AWX HTTP client
+ * @param type         Resource type (e.g., "template")
+ * @param id           Numeric resource ID
+ * @param abortSignal  Optional AbortSignal for cancellation
+ * @returns            Mapped resource output (e.g., TemplateDetailOutput)
+ * @throws             If type is unsupported or the API returns an error
+ */
+export async function getResource(client, type, id, abortSignal) {
+    const entry = RESOURCE_REGISTRY[type];
+    if (!entry) {
+        throw new Error(`Unsupported resource type: "${type}". Supported types: ${Object.keys(RESOURCE_REGISTRY).join(", ")}`);
+    }
+    const path = entry.path.replace("{id}", String(id));
+    const response = await client.request("awx-get-resource", path, undefined, abortSignal);
+    if (!response.ok) {
+        const errorBody = await response.text().catch(() => "");
+        throw new Error(`AWX API error (${response.status}): ${errorBody || response.statusText}`);
+    }
+    const raw = (await response.json());
+    return entry.mapper(raw);
+}
+//# sourceMappingURL=get-resource.js.map

package/dist/get-resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-resource.js","sourceRoot":"","sources":["../src/get-resource.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AA0B1D;;;;;;GAMG;AACH,MAAM,iBAAiB,GAAwC;IAC7D,QAAQ,EAAE;QACR,IAAI,EAAE,6BAA6B;QACnC,MAAM,EAAE,WAAW;KACpB;IACD,OAAO,EAAE;QACP,IAAI,EAAE,wBAAwB;QAC9B,MAAM,EAAE,UAAU;KACnB;IACD,SAAS,EAAE;QACT,IAAI,EAAE,2BAA2B;QACjC,MAAM,EAAE,YAAY;KACrB;CACF,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAiB,EACjB,IAAkB,EAClB,EAAU,EACV,WAAyB;IAEzB,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAEtC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,+BAA+B,IAAI,uBACjC,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,IAAI,CAC1C,EAAE,CACH,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAEpD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CACnC,kBAAkB,EAClB,IAAI,EACJ,SAAS,EACT,WAAW,CACZ,CAAC;IAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QACxD,MAAM,IAAI,KAAK,CACb,kBAAkB,QAAQ,CAAC,MAAM,MAAM,SAAS,IAAI,QAAQ,CAAC,UAAU,EAAE,CAC1E,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAY,CAAC;IAC/C,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAyB,CAAC;AACnD,CAAC"}

package/dist/index.d.ts

@@ -1,16 +1,15 @@
-import type { PluginModule } from "@opencode-ai/plugin";
-/** Plugin-specific configuration from opencode.jsonc */
-export interface AwxPluginOptions {
-    /**
-     * Base URL of the AAP/AWX instance.
-     * Must include protocol (https://) and hostname.
-     * Example: "https://example.com"
-     */
-    baseUrl?: string;
-}
+import type { Plugin } from "@opencode-ai/plugin";
 /**
- * Plugin module — the default export consumed by the OpenCode plugin server.
+ * AWX Plugin — the named async export consumed by the OpenCode plugin server.
+ *
+ * Registered in opencode.jsonc as a string-only plugin entry:
+ * ```jsonc
+ * { "plugin": ["@weiyentan/opencode-plugin-awx"] }
+ * ```
+ *
+ * Configuration is read from environment variables:
+ * - `AWX_BASE_URL`: Base URL of the AAP/AWX instance (e.g. "https://example.com")
  */
-declare const pluginModule: PluginModule;
-export default pluginModule;
+export declare const AwxPlugin: Plugin;
+export default AwxPlugin;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAsB,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAmC5E,wDAAwD;AACxD,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAsyBD;;GAEG;AACH,QAAA,MAAM,YAAY,EAAE,YAGnB,CAAC;AAEF,eAAe,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAsB,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAsgCtE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,EAAE,MAAe,CAAC;AACxC,eAAe,SAAS,CAAC"}