@agent-os-sdk/client 0.9.25 → 0.9.27

package/src/modules/traces.ts

@@ -1,133 +0,0 @@
-/**
- * Traces Module - Fully Typed
- */
-
-import type { RawClient, APIResponse, components } from "../client/raw.js";
-
-export type SpanData = components["schemas"]["SpanData"];
-type BatchIngestRequest = components["schemas"]["BatchIngestRequest"];
-type AddFeedbackRequest = components["schemas"]["AddFeedbackRequest"];
-
-export interface FeedbackRequest {
-    span_id: string;
-    score?: string;
-    comment?: string;
-    corrections?: Record<string, unknown>;
-}
-
-export interface Trace {
-    trace_id: string;
-    run_id?: string;
-    root_span_id: string;
-    name: string;
-    status: "ok" | "error" | "pending";
-    start_time: string;
-    end_time?: string;
-    duration_ms?: number;
-    span_count: number;
-}
-
-export interface Span {
-    trace_id: string;
-    span_id: string;
-    parent_span_id?: string;
-    name: string;
-    kind: string;
-    status: string;
-    status_message?: string;
-    start_time_unix_nano: number;
-    end_time_unix_nano?: number;
-    run_id?: string;
-    attributes?: Record<string, unknown>;
-    events?: unknown[];
-}
-
-export interface TraceListResponse {
-    items: Trace[];
-    total: number;
-}
-
-export interface SpanListResponse {
-    items: Span[];
-    total: number;
-}
-
-export interface TraceDetail extends Trace {
-    spans: Span[];
-}
-
-export interface SpansByRunResponse {
-    run_id: string;
-    spans: Span[];
-    count: number;
-}
-
-export class TracesModule {
-    constructor(private client: RawClient, private headers: () => Record<string, string>) { }
-
-    /**
-     * List traces.
-     */
-    async list(params?: {
-        run_id?: string;
-        from?: string;
-        to?: string;
-        limit?: number;
-        offset?: number;
-    }): Promise<APIResponse<TraceListResponse>> {
-        return this.client.GET<TraceListResponse>("/v1/api/traces", {
-            params: { query: params },
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Get a trace by ID.
-     */
-    async get(traceId: string): Promise<APIResponse<TraceDetail>> {
-        return this.client.GET<TraceDetail>("/v1/api/traces/{id}", {
-            params: { path: { id: traceId } },
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Get spans for a trace.
-     */
-    async getSpans(traceId: string): Promise<APIResponse<SpanListResponse>> {
-        return this.client.GET<SpanListResponse>("/v1/api/traces/{id}/spans", {
-            params: { path: { id: traceId } },
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Get all spans associated with a run.
-     * Maps to: GET /v1/api/traces/by-run/{runId}
-     */
-    async getByRun(runId: string): Promise<APIResponse<SpansByRunResponse>> {
-        return this.client.GET<SpansByRunResponse>(`/v1/api/traces/by-run/${runId}`, {
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Ingest spans (batch).
-     */
-    async ingest(spans: SpanData[]): Promise<APIResponse<void>> {
-        return this.client.POST<void>("/v1/api/traces/ingest", {
-            body: { spans },
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Add feedback to a span.
-     */
-    async addFeedback(feedback: FeedbackRequest): Promise<APIResponse<void>> {
-        return this.client.POST<void>("/v1/api/traces/feedback", {
-            body: feedback,
-            headers: this.headers(),
-        });
-    }
-}

package/src/modules/triggers.ts

@@ -1,357 +0,0 @@
-/**
- * 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
-    template_slug?: string;
-    is_active: boolean;
-    invoke_url: string;
-    request_contract?: TriggerRequestContract;
-    /** Custom configuration JSON (e.g., event filters, schedule cron, require_signature) */
-    config_json?: string;
-    /** JSON array of PayloadVariantConfig — defines accepted payload shapes */
-    payload_variants_json?: string;
-    /** ThreadKeySpec config: { json_path, required, fallback } */
-    thread_key_spec_json?: string;
-    /** IdempotencySpec config: { event_id_json_path, fallback } */
-    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;
-    headers: Record<string, string>;
-    signing: SigningContract;
-    body_schema_json?: string;
-    example_payload_json?: string;
-    curl_example: string;
-    curl_command_parts?: {
-        method: string;
-        url: string;
-        headers: Record<string, string>;
-        body_json?: string | null;
-    } | null;
-    /** @deprecated Use body_schema_json */
-    body_schema?: Record<string, unknown>;
-    /** @deprecated Use example_payload_json */
-    example_payload?: Record<string, unknown>;
-}
-
-export interface SigningContract {
-    algorithm: string;
-    signature_header: string;
-    timestamp_header: string;
-    timestamp_format: string;
-    string_to_sign: string;
-    signature_format: string;
-}
-
-export interface TriggerSecretResponse {
-    id: string;
-    name: string;
-    secret_key: string;
-    invoke_url: string;
-    request_contract?: TriggerRequestContract;
-    created_at: string;
-}
-
-export interface TestTriggerResponse {
-    run_id: string;
-    trigger_id: string;
-    agent_id: string;
-    status: string;
-    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;
-    external_body_schema?: JsonSchema;
-    run_input_schema?: JsonSchema;
-    effective_input_mapping_spec?: TriggerInputMappingSpec;
-    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;
-    mapping_configured: boolean;
-    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>) { }
-
-    /**
-     * List all triggers (workspace-scoped).
-     */
-    async 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(),
-        });
-    }
-
-    /**
-     * 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 });
-    }
-
-    /**
-     * 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 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(),
-        });
-    }
-
-    /**
-     * 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: {
-        name: string;
-        agent_id: string;
-        trigger_type: string;
-        template_slug?: string;
-        config?: Record<string, unknown>;
-        /** Payload variant definitions (accepted webhook shapes) */
-        payload_variants_json?: unknown;
-        /** Thread key extraction spec */
-        thread_key_spec_json?: unknown;
-        /** Idempotency key extraction spec */
-        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,
-        });
-    }
-
-    /**
-     * Update a trigger.
-     */
-    async update(triggerId: string, body: {
-        name?: string;
-        is_active?: boolean;
-        config?: Record<string, unknown>;
-        /** Payload variant definitions (accepted webhook shapes) */
-        payload_variants_json?: unknown;
-        /** Thread key extraction spec */
-        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(),
-        });
-    }
-
-    /**
-     * 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(),
-        });
-    }
-
-    /**
-     * 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: 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(),
-        });
-    }
-
-    /**
-     * 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(),
-        });
-    }
-
-    /**
-     * 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(),
-        });
-    }
-
-    /**
-     * 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(),
-        });
-    }
-
-    /**
-     * 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(),
-        });
-    }
-
-    /**
-     * 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(),
-        });
-    }
-
-    /**
-     * 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(),
-        });
-    }
-}

package/src/modules/usage.ts

@@ -1,117 +0,0 @@
-/**
- * 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;
-    quotas: {
-        runs_per_month: QuotaItem;
-        tokens_per_month: QuotaItem;
-        agents_max: QuotaItem;
-        storage_mb: QuotaItem;
-    };
-    reset_at: string;
-    source: string;
-}
-
-export interface UsageAggregated {
-    total_runs: number;
-    completed_runs: number;
-    failed_runs: number;
-    llm_events: number;
-    total_tokens: number;
-    input_tokens: number;
-    output_tokens: number;
-    total_duration_ms: number;
-    estimated_count: number;
-}
-
-export interface DailyBreakdownItem {
-    date: string;
-    runs: number;
-    llm_events: number;
-    tokens_in: number;
-    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 };
-    usage: UsageAggregated;
-    daily_breakdown: DailyBreakdownItem[];
-    provider_breakdown: ProviderBreakdownItem[];
-    source: string;
-}
-
-// =============================================================================
-// Module
-// =============================================================================
-
-export class UsageModule {
-    constructor(private client: RawClient, private headers: () => Record<string, string>) { }
-
-    /**
-     * Get current quota status (tenant-level).
-     */
-    async 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(),
-        });
-    }
-
-    /**
-     * Get usage metrics with real data from runtime.cost_events.
-     */
-    async 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(),
-        });
-    }
-}