@agent-os-sdk/client 0.9.26 → 0.9.28

package/{src/modules/triggers.ts → dist/modules/triggers.d.ts}

@@ -1,25 +1,18 @@
 /**
  * Triggers Module - Wave 5 Aligned
- * 
+ *
  * Provides typed access to trigger management and execution.
  * Follows Law 065 (Security DTO Bifurcation) - secrets only via dedicated endpoint.
  */
-
 import type { RawClient, APIResponse } from "../client/raw.js";
-
-// =============================================================================
-// Types - Wave 5 Aligned
-// =============================================================================
-
 export type JsonSchema = Record<string, unknown>;
 export type TriggerInputMappingSpec = Record<string, unknown>;
-
 export interface Trigger {
     id: string;
     name: string;
     workspace_id: string;
     agent_id: string;
-    trigger_type: string;  // String label, not union - frontend treats as display value
+    trigger_type: string;
     template_slug?: string;
     is_active: boolean;
     invoke_url: string;
@@ -34,9 +27,7 @@ export interface Trigger {
     idempotency_spec_json?: string;
     created_at: string;
     updated_at: string | null;
-    // Law 065: webhook_secret REMOVED - use getSecret() for sensitive data
 }
-
 export interface TriggerRequestContract {
     method: string;
     invoke_url: string;
@@ -56,7 +47,6 @@ export interface TriggerRequestContract {
     /** @deprecated Use example_payload_json */
     example_payload?: Record<string, unknown>;
 }
-
 export interface SigningContract {
     algorithm: string;
     signature_header: string;
@@ -65,7 +55,6 @@ export interface SigningContract {
     string_to_sign: string;
     signature_format: string;
 }
-
 export interface TriggerSecretResponse {
     id: string;
     name: string;
@@ -74,7 +63,6 @@ export interface TriggerSecretResponse {
     request_contract?: TriggerRequestContract;
     created_at: string;
 }
-
 export interface TestTriggerResponse {
     run_id: string;
     trigger_id: string;
@@ -83,16 +71,10 @@ export interface TestTriggerResponse {
     triggered_at: string;
     reused: boolean;
 }
-
 export interface TriggerListResponse {
     items: Trigger[];
     total: number;
 }
-
-// =============================================================================
-// Input Mapping Types (Wave 2)
-// =============================================================================
-
 export interface TriggerInputContractResponse {
     trigger_id: string;
     template_slug?: string;
@@ -102,13 +84,11 @@ export interface TriggerInputContractResponse {
     example_payload?: JsonSchema;
     has_input_mapping: boolean;
 }
-
 export interface MappingValidationError {
     code: string;
     path?: string;
     message: string;
 }
-
 export interface TestMappingResponse {
     original_payload: unknown;
     transformed_graph_input: unknown;
@@ -116,81 +96,52 @@ export interface TestMappingResponse {
     mapping_executed: boolean;
     validation_errors?: MappingValidationError[];
 }
-
 export interface InferSchemaPathInfo {
     path: string;
     kind: string;
 }
-
 export interface InferSchemaResponse {
     inferred_schema: JsonSchema;
     paths: InferSchemaPathInfo[];
     warnings: string[];
 }
-
 export interface SaveInputMappingResponse {
     trigger_id: string;
     input_mapping_override: TriggerInputMappingSpec;
 }
-
 export interface RegeneratedSecretResponse {
     id: string;
     secret_key: string;
     regenerated_at: string;
 }
-
-// =============================================================================
-// Module
-// =============================================================================
-
-export class TriggersModule {
-    constructor(private client: RawClient, private headers: () => Record<string, string>) { }
-
+export declare class TriggersModule {
+    private client;
+    private headers;
+    constructor(client: RawClient, headers: () => Record<string, string>);
     /**
      * List all triggers (workspace-scoped).
      */
-    async list(params?: {
+    list(params?: {
         workspace_id?: string;
         agent_id?: string;
         trigger_type?: string;
         limit?: number;
         offset?: number;
-    }): Promise<APIResponse<TriggerListResponse>> {
-        return this.client.GET<TriggerListResponse>("/v1/api/triggers", {
-            params: { query: params },
-            headers: this.headers(),
-        });
-    }
-
+    }): Promise<APIResponse<TriggerListResponse>>;
     /**
      * List triggers for a specific agent.
      * Convenience wrapper around list() with agent_id filter.
      */
-    async listByAgent(agentId: string): Promise<APIResponse<TriggerListResponse>> {
-        return this.list({ agent_id: agentId });
-    }
-
+    listByAgent(agentId: string): Promise<APIResponse<TriggerListResponse>>;
     /**
      * Get a trigger by ID.
      */
-    async get(triggerId: string): Promise<APIResponse<Trigger>> {
-        return this.client.GET<Trigger>("/v1/api/triggers/{id}", {
-            params: { path: { id: triggerId } },
-            headers: this.headers(),
-        });
-    }
-
+    get(triggerId: string): Promise<APIResponse<Trigger>>;
     /**
      * Get trigger with secret (Law 065 - Security DTO).
      * Use this when you need the webhook_secret for signing.
      */
-    async getSecret(triggerId: string): Promise<APIResponse<TriggerSecretResponse>> {
-        return this.client.GET<TriggerSecretResponse>("/v1/api/triggers/{id}/secret", {
-            params: { path: { id: triggerId } },
-            headers: this.headers(),
-        });
-    }
-
+    getSecret(triggerId: string): Promise<APIResponse<TriggerSecretResponse>>;
     /**
      * Create a new trigger.
      * @example
@@ -203,7 +154,7 @@ export class TriggersModule {
      * });
      * ```
      */
-    async create(body: {
+    create(body: {
         name: string;
         agent_id: string;
         trigger_type: string;
@@ -217,25 +168,11 @@ export class TriggersModule {
         idempotency_spec_json?: unknown;
         /** Idempotency key for safe retries. When set, duplicate requests with the same key return 409 Conflict. */
         idempotency_key?: string;
-    }): Promise<APIResponse<Trigger>> {
-        const headers: Record<string, string> = { ...this.headers() };
-        if (body.idempotency_key) {
-            headers["X-Idempotency-Key"] = body.idempotency_key;
-        }
-
-        // Send body without idempotency_key (it's header-only)
-        const { idempotency_key, ...requestBody } = body;
-
-        return this.client.POST<Trigger>("/v1/api/triggers", {
-            body: requestBody,
-            headers,
-        });
-    }
-
+    }): Promise<APIResponse<Trigger>>;
     /**
      * Update a trigger.
      */
-    async update(triggerId: string, body: {
+    update(triggerId: string, body: {
         name?: string;
         is_active?: boolean;
         config?: Record<string, unknown>;
@@ -245,24 +182,11 @@ export class TriggersModule {
         thread_key_spec_json?: unknown;
         /** Idempotency key extraction spec */
         idempotency_spec_json?: unknown;
-    }): Promise<APIResponse<Trigger>> {
-        return this.client.PATCH<Trigger>("/v1/api/triggers/{id}", {
-            params: { path: { id: triggerId } },
-            body,
-            headers: this.headers(),
-        });
-    }
-
+    }): Promise<APIResponse<Trigger>>;
     /**
      * Delete a trigger.
      */
-    async delete(triggerId: string): Promise<APIResponse<void>> {
-        return this.client.DELETE<void>("/v1/api/triggers/{id}", {
-            params: { path: { id: triggerId } },
-            headers: this.headers(),
-        });
-    }
-
+    delete(triggerId: string): Promise<APIResponse<void>>;
     /**
      * Test a trigger (server-side execution).
      * Avoids client-side secret exposure - server signs the request.
@@ -271,87 +195,34 @@ export class TriggersModule {
      * @param threadKey - Optional thread key for conversation context
      * @param idempotencyKey - Optional idempotency key for deduplication
      */
-    async test(triggerId: string, payload?: unknown, threadKey?: string, idempotencyKey?: string): Promise<APIResponse<TestTriggerResponse>> {
-        return this.client.POST<TestTriggerResponse>("/v1/api/triggers/{id}/test", {
-            params: { path: { id: triggerId } },
-            body: {
-                payload: payload ?? undefined,
-                thread_key: threadKey ?? undefined,
-                idempotency_key: idempotencyKey ?? undefined,
-            },
-            headers: this.headers(),
-        });
-    }
-
+    test(triggerId: string, payload?: unknown, threadKey?: string, idempotencyKey?: string): Promise<APIResponse<TestTriggerResponse>>;
     /**
      * Get the full input contract for a trigger.
      * Returns schemas and mapping spec for transformation configuration.
      */
-    async getContract(triggerId: string): Promise<APIResponse<TriggerInputContractResponse>> {
-        return this.client.GET<TriggerInputContractResponse>("/v1/api/triggers/{id}/contract", {
-            params: { path: { id: triggerId } },
-            headers: this.headers(),
-        });
-    }
-
+    getContract(triggerId: string): Promise<APIResponse<TriggerInputContractResponse>>;
     /**
      * Test input mapping transformation without executing a run.
      * Preview how a payload will be transformed before execution.
      * @param triggerId - The trigger to test mapping for
      * @param samplePayload - Sample payload to transform
      */
-    async testMapping(triggerId: string, samplePayload: unknown): Promise<APIResponse<TestMappingResponse>> {
-        return this.client.POST<TestMappingResponse>("/v1/api/triggers/{id}/test-mapping", {
-            params: { path: { id: triggerId } },
-            body: { sample_payload: samplePayload },
-            headers: this.headers(),
-        });
-    }
-
+    testMapping(triggerId: string, samplePayload: unknown): Promise<APIResponse<TestMappingResponse>>;
     /**
      * Regenerate the webhook secret for a trigger.
      */
-    async regenerateSecret(triggerId: string): Promise<APIResponse<RegeneratedSecretResponse>> {
-        return this.client.POST<RegeneratedSecretResponse>("/v1/api/triggers/{id}/regenerate-secret", {
-            params: { path: { id: triggerId } },
-            headers: this.headers(),
-        });
-    }
-
+    regenerateSecret(triggerId: string): Promise<APIResponse<RegeneratedSecretResponse>>;
     /**
      * Infer schema from a sample payload.
      */
-    async inferSchema(triggerId: string, samplePayload: unknown): Promise<APIResponse<InferSchemaResponse>> {
-        return this.client.POST<InferSchemaResponse>("/v1/api/triggers/{id}/infer-schema", {
-            params: { path: { id: triggerId } },
-            body: { sample_payload: samplePayload },
-            headers: this.headers(),
-        });
-    }
-
+    inferSchema(triggerId: string, samplePayload: unknown): Promise<APIResponse<InferSchemaResponse>>;
     /**
      * Set/update the input mapping for a trigger.
      */
-    async putInputMapping(triggerId: string, inputMappingOverride: TriggerInputMappingSpec): Promise<APIResponse<SaveInputMappingResponse>> {
-        return this.client.PUT<SaveInputMappingResponse>("/v1/api/triggers/{id}/input-mapping", {
-            params: { path: { id: triggerId } },
-            body: { input_mapping_override: inputMappingOverride },
-            headers: this.headers(),
-        });
-    }
-
+    putInputMapping(triggerId: string, inputMappingOverride: TriggerInputMappingSpec): Promise<APIResponse<SaveInputMappingResponse>>;
     /**
      * Preview input mapping transformation result.
      */
-    async previewInputMapping(
-        triggerId: string,
-        samplePayload: unknown,
-        inputMappingOverride: TriggerInputMappingSpec
-    ): Promise<APIResponse<TestMappingResponse>> {
-        return this.client.POST<TestMappingResponse>("/v1/api/triggers/{id}/preview-input-mapping", {
-            params: { path: { id: triggerId } },
-            body: { sample_payload: samplePayload, input_mapping_override: inputMappingOverride },
-            headers: this.headers(),
-        });
-    }
+    previewInputMapping(triggerId: string, samplePayload: unknown, inputMappingOverride: TriggerInputMappingSpec): Promise<APIResponse<TestMappingResponse>>;
 }
+//# sourceMappingURL=triggers.d.ts.map

package/dist/modules/triggers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.d.ts","sourceRoot":"","sources":["../../src/modules/triggers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAM/D,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACjD,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE9D,MAAM,WAAW,OAAO;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAC1C,wFAAwF;IACxF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,8DAA8D;IAC9D,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,+DAA+D;IAC/D,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAE7B;AAED,MAAM,WAAW,sBAAsB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,EAAE,eAAe,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC7B,GAAG,IAAI,CAAC;IACT,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,2CAA2C;IAC3C,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,eAAe;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,qBAAqB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAC1C,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAChC,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACjB;AAMD,MAAM,WAAW,4BAA4B;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oBAAoB,CAAC,EAAE,UAAU,CAAC;IAClC,gBAAgB,CAAC,EAAE,UAAU,CAAC;IAC9B,4BAA4B,CAAC,EAAE,uBAAuB,CAAC;IACvD,eAAe,CAAC,EAAE,UAAU,CAAC;IAC7B,iBAAiB,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,sBAAsB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAChC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,uBAAuB,EAAE,OAAO,CAAC;IACjC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,iBAAiB,CAAC,EAAE,sBAAsB,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAChC,eAAe,EAAE,UAAU,CAAC;IAC5B,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB,EAAE,uBAAuB,CAAC;CACnD;AAED,MAAM,WAAW,yBAAyB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CAC1B;AAMD,qBAAa,cAAc;IACX,OAAO,CAAC,MAAM;IAAa,OAAO,CAAC,OAAO;gBAAlC,MAAM,EAAE,SAAS,EAAU,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAEpF;;OAEG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE;QAChB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC;IAO7C;;;OAGG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC;IAI7E;;OAEG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAO3D;;;OAGG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC;IAO/E;;;;;;;;;;;OAWG;IACG,MAAM,CAAC,IAAI,EAAE;QACf,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,4DAA4D;QAC5D,qBAAqB,CAAC,EAAE,OAAO,CAAC;QAChC,iCAAiC;QACjC,oBAAoB,CAAC,EAAE,OAAO,CAAC;QAC/B,sCAAsC;QACtC,qBAAqB,CAAC,EAAE,OAAO,CAAC;QAChC,4GAA4G;QAC5G,eAAe,CAAC,EAAE,MAAM,CAAC;KAC5B,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAejC;;OAEG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE;QAClC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,4DAA4D;QAC5D,qBAAqB,CAAC,EAAE,OAAO,CAAC;QAChC,iCAAiC;QACjC,oBAAoB,CAAC,EAAE,OAAO,CAAC;QAC/B,sCAAsC;QACtC,qBAAqB,CAAC,EAAE,OAAO,CAAC;KACnC,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAQjC;;OAEG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAO3D;;;;;;;OAOG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC;IAYxI;;;OAGG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,4BAA4B,CAAC,CAAC;IAOxF;;;;;OAKG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC;IAQvG;;OAEG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,yBAAyB,CAAC,CAAC;IAO1F;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC;IAQvG;;OAEG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,oBAAoB,EAAE,uBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC,wBAAwB,CAAC,CAAC;IAQvI;;OAEG;IACG,mBAAmB,CACrB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,OAAO,EACtB,oBAAoB,EAAE,uBAAuB,GAC9C,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC;CAO/C"}

package/dist/modules/triggers.js

@@ -0,0 +1,176 @@
+/**
+ * Triggers Module - Wave 5 Aligned
+ *
+ * Provides typed access to trigger management and execution.
+ * Follows Law 065 (Security DTO Bifurcation) - secrets only via dedicated endpoint.
+ */
+// =============================================================================
+// Module
+// =============================================================================
+export class TriggersModule {
+    client;
+    headers;
+    constructor(client, headers) {
+        this.client = client;
+        this.headers = headers;
+    }
+    /**
+     * List all triggers (workspace-scoped).
+     */
+    async list(params) {
+        return this.client.GET("/v1/api/triggers", {
+            params: { query: params },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * List triggers for a specific agent.
+     * Convenience wrapper around list() with agent_id filter.
+     */
+    async listByAgent(agentId) {
+        return this.list({ agent_id: agentId });
+    }
+    /**
+     * Get a trigger by ID.
+     */
+    async get(triggerId) {
+        return this.client.GET("/v1/api/triggers/{id}", {
+            params: { path: { id: triggerId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Get trigger with secret (Law 065 - Security DTO).
+     * Use this when you need the webhook_secret for signing.
+     */
+    async getSecret(triggerId) {
+        return this.client.GET("/v1/api/triggers/{id}/secret", {
+            params: { path: { id: triggerId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Create a new trigger.
+     * @example
+     * ```ts
+     * const { data: trigger } = await client.triggers.create({
+     *   name: "My Webhook",
+     *   agent_id: "agent-uuid",
+     *   trigger_type: "webhook",
+     *   idempotency_key: "create-trigger-unique-key"
+     * });
+     * ```
+     */
+    async create(body) {
+        const headers = { ...this.headers() };
+        if (body.idempotency_key) {
+            headers["X-Idempotency-Key"] = body.idempotency_key;
+        }
+        // Send body without idempotency_key (it's header-only)
+        const { idempotency_key, ...requestBody } = body;
+        return this.client.POST("/v1/api/triggers", {
+            body: requestBody,
+            headers,
+        });
+    }
+    /**
+     * Update a trigger.
+     */
+    async update(triggerId, body) {
+        return this.client.PATCH("/v1/api/triggers/{id}", {
+            params: { path: { id: triggerId } },
+            body,
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Delete a trigger.
+     */
+    async delete(triggerId) {
+        return this.client.DELETE("/v1/api/triggers/{id}", {
+            params: { path: { id: triggerId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Test a trigger (server-side execution).
+     * Avoids client-side secret exposure - server signs the request.
+     * @param triggerId - The trigger to test
+     * @param payload - Optional JSON payload (wrapped in { payload: ... } per backend contract)
+     * @param threadKey - Optional thread key for conversation context
+     * @param idempotencyKey - Optional idempotency key for deduplication
+     */
+    async test(triggerId, payload, threadKey, idempotencyKey) {
+        return this.client.POST("/v1/api/triggers/{id}/test", {
+            params: { path: { id: triggerId } },
+            body: {
+                payload: payload ?? undefined,
+                thread_key: threadKey ?? undefined,
+                idempotency_key: idempotencyKey ?? undefined,
+            },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Get the full input contract for a trigger.
+     * Returns schemas and mapping spec for transformation configuration.
+     */
+    async getContract(triggerId) {
+        return this.client.GET("/v1/api/triggers/{id}/contract", {
+            params: { path: { id: triggerId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Test input mapping transformation without executing a run.
+     * Preview how a payload will be transformed before execution.
+     * @param triggerId - The trigger to test mapping for
+     * @param samplePayload - Sample payload to transform
+     */
+    async testMapping(triggerId, samplePayload) {
+        return this.client.POST("/v1/api/triggers/{id}/test-mapping", {
+            params: { path: { id: triggerId } },
+            body: { sample_payload: samplePayload },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Regenerate the webhook secret for a trigger.
+     */
+    async regenerateSecret(triggerId) {
+        return this.client.POST("/v1/api/triggers/{id}/regenerate-secret", {
+            params: { path: { id: triggerId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Infer schema from a sample payload.
+     */
+    async inferSchema(triggerId, samplePayload) {
+        return this.client.POST("/v1/api/triggers/{id}/infer-schema", {
+            params: { path: { id: triggerId } },
+            body: { sample_payload: samplePayload },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Set/update the input mapping for a trigger.
+     */
+    async putInputMapping(triggerId, inputMappingOverride) {
+        return this.client.PUT("/v1/api/triggers/{id}/input-mapping", {
+            params: { path: { id: triggerId } },
+            body: { input_mapping_override: inputMappingOverride },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Preview input mapping transformation result.
+     */
+    async previewInputMapping(triggerId, samplePayload, inputMappingOverride) {
+        return this.client.POST("/v1/api/triggers/{id}/preview-input-mapping", {
+            params: { path: { id: triggerId } },
+            body: { sample_payload: samplePayload, input_mapping_override: inputMappingOverride },
+            headers: this.headers(),
+        });
+    }
+}

package/{src/modules/usage.ts → dist/modules/usage.d.ts}

@@ -1,22 +1,15 @@
 /**
  * Usage Module — Tenant-level usage metrics and quotas.
- * 
+ *
  * Endpoints: GET /v1/api/quotas, GET /v1/api/usage
  * Source: runtime.cost_events aggregation
  */
-
 import type { RawClient, APIResponse } from "../client/raw.js";
-
-// =============================================================================
-// Types
-// =============================================================================
-
 export interface QuotaItem {
     limit: number;
     used: number;
     remaining: number;
 }
-
 export interface QuotasResponse {
     tenant_id: string;
     workspace_id?: string;
@@ -29,7 +22,6 @@ export interface QuotasResponse {
     reset_at: string;
     source: string;
 }
-
 export interface UsageAggregated {
     total_runs: number;
     completed_runs: number;
@@ -41,7 +33,6 @@ export interface UsageAggregated {
     total_duration_ms: number;
     estimated_count: number;
 }
-
 export interface DailyBreakdownItem {
     date: string;
     runs: number;
@@ -50,68 +41,45 @@ export interface DailyBreakdownItem {
     tokens_out: number;
     duration_ms: number;
 }
-
 export interface ProviderBreakdownItem {
     provider: string;
     runs: number;
     llm_events: number;
     tokens: number;
 }
-
 export interface UsageResponse {
     tenant_id: string;
     workspace_id?: string;
-    period: { from: string; to: string };
+    period: {
+        from: string;
+        to: string;
+    };
     usage: UsageAggregated;
     daily_breakdown: DailyBreakdownItem[];
     provider_breakdown: ProviderBreakdownItem[];
     source: string;
 }
-
-// =============================================================================
-// Module
-// =============================================================================
-
-export class UsageModule {
-    constructor(private client: RawClient, private headers: () => Record<string, string>) { }
-
+export declare class UsageModule {
+    private client;
+    private headers;
+    constructor(client: RawClient, headers: () => Record<string, string>);
     /**
      * Get current quota status (tenant-level).
      */
-    async getQuotas(params?: {
+    getQuotas(params?: {
         workspaceId?: string;
         /** @deprecated Use workspaceId */
         workspace_id?: string;
-    }): Promise<APIResponse<QuotasResponse>> {
-        const query = {
-            workspaceId: params?.workspaceId ?? params?.workspace_id,
-        };
-
-        return this.client.GET<QuotasResponse>("/v1/api/quotas", {
-            params: { query },
-            headers: this.headers(),
-        });
-    }
-
+    }): Promise<APIResponse<QuotasResponse>>;
     /**
      * Get usage metrics with real data from runtime.cost_events.
      */
-    async getUsage(params?: {
+    getUsage(params?: {
         workspaceId?: string;
         /** @deprecated Use workspaceId */
         workspace_id?: string;
         from?: string;
         to?: string;
-    }): Promise<APIResponse<UsageResponse>> {
-        const query = {
-            workspaceId: params?.workspaceId ?? params?.workspace_id,
-            from: params?.from,
-            to: params?.to,
-        };
-
-        return this.client.GET<UsageResponse>("/v1/api/usage", {
-            params: { query },
-            headers: this.headers(),
-        });
-    }
+    }): Promise<APIResponse<UsageResponse>>;
 }
+//# sourceMappingURL=usage.d.ts.map

package/dist/modules/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/modules/usage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAM/D,MAAM,WAAW,SAAS;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE;QACJ,cAAc,EAAE,SAAS,CAAC;QAC1B,gBAAgB,EAAE,SAAS,CAAC;QAC5B,UAAU,EAAE,SAAS,CAAC;QACtB,UAAU,EAAE,SAAS,CAAC;KACzB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,KAAK,EAAE,eAAe,CAAC;IACvB,eAAe,EAAE,kBAAkB,EAAE,CAAC;IACtC,kBAAkB,EAAE,qBAAqB,EAAE,CAAC;IAC5C,MAAM,EAAE,MAAM,CAAC;CAClB;AAMD,qBAAa,WAAW;IACR,OAAO,CAAC,MAAM;IAAa,OAAO,CAAC,OAAO;gBAAlC,MAAM,EAAE,SAAS,EAAU,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAEpF;;OAEG;IACG,SAAS,CAAC,MAAM,CAAC,EAAE;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,kCAAkC;QAClC,YAAY,CAAC,EAAE,MAAM,CAAC;KACzB,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAWxC;;OAEG;IACG,QAAQ,CAAC,MAAM,CAAC,EAAE;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,kCAAkC;QAClC,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;CAY1C"}