@archastro/sdk 0.5.2 → 0.6.0

package/dist/v1/resources/automation_runs.d.ts

@@ -4,10 +4,14 @@ export declare class AutomationRunResource {
     private http;
     constructor(http: HttpClient);
     /**
-     * Get a single invoked automation run
-     * Fetches one run created by an invoked automation.
-     * This public lookup route only returns runs whose parent automation has
-     * `type: :invoked`.
+     * Retrieve an automation run
+     * Returns a single run created by an invoked automation.
+     * This endpoint is restricted to runs whose parent automation has
+     * `type: "invoked"`. Attempting to retrieve a run from a non-invoked
+     * automation returns 404. The authenticated user must have access to the
+     * automation run's parent automation within their workspace.
+     * @param automationRun - Automation run ID (`arun_...`). Must belong to an invoked automation accessible to the authenticated user.
+     * @returns The requested automation run.
      */
     get(automationRun: string): Promise<AutomationRun>;
 }

package/dist/v1/resources/automation_runs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"automation_runs.d.ts","sourceRoot":"","sources":["../../../src/v1/resources/automation_runs.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEhE,qBAAa,qBAAqB;IACpB,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEpC;;;;;OAKG;IACG,GAAG,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAGzD"}
+{"version":3,"file":"automation_runs.d.ts","sourceRoot":"","sources":["../../../src/v1/resources/automation_runs.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEhE,qBAAa,qBAAqB;IACpB,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEpC;;;;;;;;;OASG;IACG,GAAG,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAGzD"}

package/dist/v1/resources/automation_runs.js

@@ -1,16 +1,20 @@
 // Copyright (c) 2026 ArchAstro Inc. All Rights Reserved.
 // This file is auto-generated by @archastro/sdk-generator. Do not edit.
-// Content hash: 1b3c68c546f2
+// Content hash: 99110a203b3c
 export class AutomationRunResource {
     http;
     constructor(http) {
         this.http = http;
     }
     /**
-     * Get a single invoked automation run
-     * Fetches one run created by an invoked automation.
-     * This public lookup route only returns runs whose parent automation has
-     * `type: :invoked`.
+     * Retrieve an automation run
+     * Returns a single run created by an invoked automation.
+     * This endpoint is restricted to runs whose parent automation has
+     * `type: "invoked"`. Attempting to retrieve a run from a non-invoked
+     * automation returns 404. The authenticated user must have access to the
+     * automation run's parent automation within their workspace.
+     * @param automationRun - Automation run ID (`arun_...`). Must belong to an invoked automation accessible to the authenticated user.
+     * @returns The requested automation run.
      */
     async get(automationRun) {
         return this.http.request(`/api/v1/automation_runs/${automationRun}`);

package/dist/v1/resources/automation_runs.js.map

@@ -1 +1 @@
-{"version":3,"file":"automation_runs.js","sourceRoot":"","sources":["../../../src/v1/resources/automation_runs.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,wEAAwE;AACxE,6BAA6B;AAK7B,MAAM,OAAO,qBAAqB;IACZ;IAApB,YAAoB,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAExC;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAC,aAAqB;QAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,2BAA2B,aAAa,EAAE,CAAC,CAAC;IACvE,CAAC;CACF"}
+{"version":3,"file":"automation_runs.js","sourceRoot":"","sources":["../../../src/v1/resources/automation_runs.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,wEAAwE;AACxE,6BAA6B;AAK7B,MAAM,OAAO,qBAAqB;IACZ;IAApB,YAAoB,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAExC;;;;;;;;;OASG;IACH,KAAK,CAAC,GAAG,CAAC,aAAqB;QAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,2BAA2B,aAAa,EAAE,CAAC,CAAC;IACvE,CAAC;CACF"}

package/dist/v1/resources/automations.d.ts

@@ -3,6 +3,26 @@ import type { AutomationRun } from "../../types/automations.js";
 export declare class AutomationResource {
     private http;
     constructor(http: HttpClient);
+    /**
+     * Invoke an automation
+     * Triggers a single run of an automation that has `type: "invoked"`. Returns
+     * the resulting automation run object, which you can use to poll or display
+     * run status.
+     * Both server-to-server (secret key) and user (publishable key + JWT) auth
+     * are supported. The automation's `invoke_auth` setting controls which auth
+     * modes are accepted; requests using an unsupported mode are rejected with
+     * 403. For server-to-server callers the run executes under the identity
+     * configured in the automation's `run_as_user` or `run_as_agent` fields. For
+     * authenticated user callers the invoking user's identity is used
+     * automatically.
+     * If you supply an `idempotency_key`, a second request with the same key
+     * returns the existing run rather than creating a new one.
+     * @param automation - Automation ID (`auto_...`) or `lookup_key` of the automation to invoke.
+     * @param input - Request body.
+     * @param input.idempotency_key - Unique key to deduplicate concurrent or retried invocations. A second request with the same key returns the existing run instead of creating a new one.
+     * @param input.payload - Arbitrary input data passed to the automation. Validated against the automation's `input_schema` when one is configured; the request is rejected with 422 if validation fails.
+     * @returns The automation run created by this invocation.
+     */
     invoke(automation: string, input: {
         idempotency_key?: string | undefined;
         payload?: Record<string, unknown> | undefined;

package/dist/v1/resources/automations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"automations.d.ts","sourceRoot":"","sources":["../../../src/v1/resources/automations.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEhE,qBAAa,kBAAkB;IACjB,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE9B,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC;CAGzJ"}
+{"version":3,"file":"automations.d.ts","sourceRoot":"","sources":["../../../src/v1/resources/automations.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEhE,qBAAa,kBAAkB;IACjB,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEpC;;;;;;;;;;;;;;;;;;;OAmBG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC;CAGzJ"}

package/dist/v1/resources/automations.js

@@ -1,11 +1,31 @@
 // Copyright (c) 2026 ArchAstro Inc. All Rights Reserved.
 // This file is auto-generated by @archastro/sdk-generator. Do not edit.
-// Content hash: d494c552974e
+// Content hash: 70e11fbc7082
 export class AutomationResource {
     http;
     constructor(http) {
         this.http = http;
     }
+    /**
+     * Invoke an automation
+     * Triggers a single run of an automation that has `type: "invoked"`. Returns
+     * the resulting automation run object, which you can use to poll or display
+     * run status.
+     * Both server-to-server (secret key) and user (publishable key + JWT) auth
+     * are supported. The automation's `invoke_auth` setting controls which auth
+     * modes are accepted; requests using an unsupported mode are rejected with
+     * 403. For server-to-server callers the run executes under the identity
+     * configured in the automation's `run_as_user` or `run_as_agent` fields. For
+     * authenticated user callers the invoking user's identity is used
+     * automatically.
+     * If you supply an `idempotency_key`, a second request with the same key
+     * returns the existing run rather than creating a new one.
+     * @param automation - Automation ID (`auto_...`) or `lookup_key` of the automation to invoke.
+     * @param input - Request body.
+     * @param input.idempotency_key - Unique key to deduplicate concurrent or retried invocations. A second request with the same key returns the existing run instead of creating a new one.
+     * @param input.payload - Arbitrary input data passed to the automation. Validated against the automation's `input_schema` when one is configured; the request is rejected with 422 if validation fails.
+     * @returns The automation run created by this invocation.
+     */
     async invoke(automation, input) {
         return this.http.request(`/api/v1/automations/${automation}/invoke`, { method: "POST", body: input });
     }

package/dist/v1/resources/automations.js.map

@@ -1 +1 @@
-{"version":3,"file":"automations.js","sourceRoot":"","sources":["../../../src/v1/resources/automations.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,wEAAwE;AACxE,6BAA6B;AAK7B,MAAM,OAAO,kBAAkB;IACT;IAApB,YAAoB,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAExC,KAAK,CAAC,MAAM,CAAC,UAAkB,EAAE,KAA8F;QAC7H,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,uBAAuB,UAAU,SAAS,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACxG,CAAC;CACF"}
+{"version":3,"file":"automations.js","sourceRoot":"","sources":["../../../src/v1/resources/automations.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,wEAAwE;AACxE,6BAA6B;AAK7B,MAAM,OAAO,kBAAkB;IACT;IAApB,YAAoB,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAExC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,KAAK,CAAC,MAAM,CAAC,UAAkB,EAAE,KAA8F;QAC7H,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,uBAAuB,UAAU,SAAS,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACxG,CAAC;CACF"}

package/dist/v1/resources/bug_reports.d.ts

@@ -0,0 +1,29 @@
+import { HttpClient } from "../../runtime/http-client.js";
+import type { BugReport } from "../../types/common.js";
+export declare class BugReportResource {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * Submit a bug report
+     * Creates a bug report or freeform feedback entry on behalf of the authenticated user.
+     * The `description` is stored in full; the `context` blob is stored verbatim and surfaced
+     * during triage. Callers should include relevant session identifiers (URL, thread ID, etc.)
+     * in `context` to speed up reproduction.
+     * This endpoint requires authentication. Submissions are rate-limited to 10 reports per
+     * user per hour; exceeding that limit returns 429. The `client` value must be one of the
+     * recognised string identifiers listed below — an unrecognised value returns 400.
+     * @param input - Request body.
+     * @param input.client - Identifier of the submitting client. One of `"agent_network_web"`, `"cli"`, or `"developer_portal"`.
+     * @param input.client_version - Build SHA or package version of the client.
+     * @param input.context - Optional client-shaped context blob; ≤5 KB serialized. Stored verbatim and surfaced for triage — clients commonly include url, user_agent, thread_id, message_id, etc.
+     * @param input.description - Freeform report text. 1–10,000 chars after trim.
+     * @returns The created bug report record.
+     */
+    create(input: {
+        client: string;
+        client_version: string;
+        context?: Record<string, unknown> | undefined;
+        description: string;
+    }): Promise<BugReport>;
+}
+//# sourceMappingURL=bug_reports.d.ts.map

package/dist/v1/resources/bug_reports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bug_reports.d.ts","sourceRoot":"","sources":["../../../src/v1/resources/bug_reports.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,qBAAa,iBAAiB;IAChB,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEpC;;;;;;;;;;;;;;;OAeG;IACG,MAAM,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,CAAC;CAGxJ"}

package/dist/v1/resources/bug_reports.js

@@ -0,0 +1,29 @@
+// Copyright (c) 2026 ArchAstro Inc. All Rights Reserved.
+// This file is auto-generated by @archastro/sdk-generator. Do not edit.
+// Content hash: 5f8b125f55d0
+export class BugReportResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Submit a bug report
+     * Creates a bug report or freeform feedback entry on behalf of the authenticated user.
+     * The `description` is stored in full; the `context` blob is stored verbatim and surfaced
+     * during triage. Callers should include relevant session identifiers (URL, thread ID, etc.)
+     * in `context` to speed up reproduction.
+     * This endpoint requires authentication. Submissions are rate-limited to 10 reports per
+     * user per hour; exceeding that limit returns 429. The `client` value must be one of the
+     * recognised string identifiers listed below — an unrecognised value returns 400.
+     * @param input - Request body.
+     * @param input.client - Identifier of the submitting client. One of `"agent_network_web"`, `"cli"`, or `"developer_portal"`.
+     * @param input.client_version - Build SHA or package version of the client.
+     * @param input.context - Optional client-shaped context blob; ≤5 KB serialized. Stored verbatim and surfaced for triage — clients commonly include url, user_agent, thread_id, message_id, etc.
+     * @param input.description - Freeform report text. 1–10,000 chars after trim.
+     * @returns The created bug report record.
+     */
+    async create(input) {
+        return this.http.request(`/api/v1/bug_reports`, { method: "POST", body: input });
+    }
+}
+//# sourceMappingURL=bug_reports.js.map

package/dist/v1/resources/bug_reports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bug_reports.js","sourceRoot":"","sources":["../../../src/v1/resources/bug_reports.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,wEAAwE;AACxE,6BAA6B;AAK7B,MAAM,OAAO,iBAAiB;IACR;IAApB,YAAoB,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAExC;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,MAAM,CAAC,KAAqH;QAChI,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACnF,CAAC;CACF"}