@agent-os-sdk/client 0.1.2 → 0.2.2

package/dist/modules/policies.d.ts

@@ -1,103 +1,76 @@
 /**
- * Policies Module - Governance Rules
+ * Policies Module - Governance & Compliance
  *
- * // MOCK - This module contains mock implementations for future features
- *
- * Defines and evaluates policies that control agent behavior.
- * Enables enterprise governance and compliance.
+ * NOT IMPLEMENTED - Backend endpoint not available.
+ * All methods return 501 NotImplemented.
  */
 import type { RawClient, APIResponse } from "../client/raw.js";
-export type PolicyType = "allow" | "deny" | "require_approval" | "audit";
-export type PolicyScope = "tenant" | "workspace" | "agent" | "run";
+export type PolicyScope = "agent" | "workspace" | "tenant" | "global";
+export type PolicyEnforcement = "hard" | "soft" | "audit_only";
+export interface PolicyRule {
+    id: string;
+    type: "allow" | "deny" | "require_approval" | "log";
+    condition: string;
+    action?: string;
+    message?: string;
+}
 export interface Policy {
     id: string;
     name: string;
     description?: string;
-    type: PolicyType;
     scope: PolicyScope;
     scope_id?: string;
-    conditions: PolicyCondition[];
-    actions: PolicyAction[];
-    priority: number;
+    enforcement: PolicyEnforcement;
+    rules: PolicyRule[];
     enabled: boolean;
+    priority: number;
     created_at: string;
     updated_at: string;
 }
-export interface PolicyCondition {
-    field: string;
-    operator: "eq" | "neq" | "in" | "not_in" | "gt" | "lt" | "contains" | "regex";
-    value: unknown;
-}
-export interface PolicyAction {
-    type: "block" | "allow" | "require_approval" | "log" | "alert" | "modify";
-    config?: Record<string, unknown>;
-}
-export interface PolicyEvaluationInput {
-    action: string;
-    resource: string;
-    context: Record<string, unknown>;
-}
-export interface PolicyEvaluationResult {
-    allowed: boolean;
-    matched_policies: string[];
-    required_approvals: string[];
-    warnings: string[];
-    audit_entries: PolicyAuditEntry[];
-}
-export interface PolicyAuditEntry {
+export interface PolicyEvaluation {
     policy_id: string;
     policy_name: string;
-    decision: "allow" | "deny" | "pending_approval";
-    reason: string;
-    evaluated_at: string;
+    passed: boolean;
+    violated_rules: PolicyRule[];
+    audit_log_id?: string;
 }
-export interface PolicyListResponse {
-    items: Policy[];
-    total: number;
+export interface PolicyEvaluationResult {
+    allowed: boolean;
+    evaluations: PolicyEvaluation[];
+    requires_approval: boolean;
+    blocking_policies: string[];
 }
 export declare class PoliciesModule {
     private client;
     private headers;
     constructor(client: RawClient, headers: () => Record<string, string>);
-    /**
-     * List all policies.
-     */
+    /** @returns 501 Not Implemented */
     list(params?: {
         scope?: PolicyScope;
+        scope_id?: string;
         enabled?: boolean;
-    }): Promise<APIResponse<PolicyListResponse>>;
-    /**
-     * Get a policy by ID.
-     */
+        limit?: number;
+        offset?: number;
+    }): Promise<APIResponse<{
+        items: Policy[];
+        total: number;
+    }>>;
+    /** @returns 501 Not Implemented */
     get(policyId: string): Promise<APIResponse<Policy>>;
-    /**
-     * Create a new policy.
-     */
+    /** @returns 501 Not Implemented */
     create(body: {
         name: string;
         description?: string;
-        type: PolicyType;
         scope: PolicyScope;
         scope_id?: string;
-        conditions: PolicyCondition[];
-        actions: PolicyAction[];
-        priority?: number;
+        enforcement: PolicyEnforcement;
+        rules: PolicyRule[];
     }): Promise<APIResponse<Policy>>;
-    /**
-     * Update a policy.
-     */
-    update(policyId: string, body: Partial<Policy>): Promise<APIResponse<Policy>>;
-    /**
-     * Delete a policy.
-     */
-    delete(policyId: string): Promise<APIResponse<void>>;
-    /**
-     * Evaluate policies against an action (simulation).
-     */
-    evaluate(input: PolicyEvaluationInput): Promise<APIResponse<PolicyEvaluationResult>>;
-    /**
-     * Enforce policies (apply to current context).
-     */
-    enforce(runId: string): Promise<APIResponse<PolicyEvaluationResult>>;
+    /** @returns 501 Not Implemented */
+    evaluate(context: {
+        agent_id: string;
+        action: string;
+        payload?: Record<string, unknown>;
+    }): Promise<APIResponse<PolicyEvaluationResult>>;
 }
 //# sourceMappingURL=policies.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"policies.d.ts","sourceRoot":"","sources":["../../src/modules/policies.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"policies.d.ts","sourceRoot":"","sources":["../../src/modules/policies.ts"],"names":[],"mappings":"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"}

package/dist/modules/policies.js

@@ -1,12 +1,23 @@
 /**
- * Policies Module - Governance Rules
+ * Policies Module - Governance & Compliance
  *
- * // MOCK - This module contains mock implementations for future features
- *
- * Defines and evaluates policies that control agent behavior.
- * Enables enterprise governance and compliance.
+ * NOT IMPLEMENTED - Backend endpoint not available.
+ * All methods return 501 NotImplemented.
  */
 // ============================================================================
+// Helper for 501 responses
+// ============================================================================
+function notImplemented(method) {
+    return {
+        data: undefined,
+        error: {
+            code: "NOT_IMPLEMENTED",
+            message: `PoliciesModule.${method}() is not implemented. Backend endpoint not available.`,
+        },
+        response: new Response(null, { status: 501, statusText: "Not Implemented" }),
+    };
+}
+// ============================================================================
 // Module
 // ============================================================================
 export class PoliciesModule {
@@ -16,165 +27,20 @@ export class PoliciesModule {
         this.client = client;
         this.headers = headers;
     }
-    // MOCK - Simulated list
-    /**
-     * List all policies.
-     */
+    /** @returns 501 Not Implemented */
     async list(params) {
-        // MOCK - Returns simulated data
-        const mockPolicies = {
-            items: [
-                {
-                    id: "policy_1",
-                    name: "Block External Email",
-                    description: "Prevent agents from sending external emails without approval",
-                    type: "require_approval",
-                    scope: "tenant",
-                    conditions: [
-                        { field: "action", operator: "eq", value: "send_email" },
-                        { field: "recipient.domain", operator: "not_in", value: ["company.com"] },
-                    ],
-                    actions: [
-                        { type: "require_approval", config: { approver_role: "admin" } },
-                    ],
-                    priority: 100,
-                    enabled: true,
-                    created_at: new Date(Date.now() - 86400000).toISOString(),
-                    updated_at: new Date().toISOString(),
-                },
-                {
-                    id: "policy_2",
-                    name: "Audit All Tool Calls",
-                    description: "Log all tool calls for compliance",
-                    type: "audit",
-                    scope: "tenant",
-                    conditions: [
-                        { field: "action", operator: "eq", value: "tool_call" },
-                    ],
-                    actions: [
-                        { type: "log" },
-                    ],
-                    priority: 50,
-                    enabled: true,
-                    created_at: new Date(Date.now() - 86400000).toISOString(),
-                    updated_at: new Date().toISOString(),
-                },
-            ],
-            total: 2,
-        };
-        return { data: mockPolicies, error: undefined, response: new Response() };
+        return notImplemented("list");
     }
-    // MOCK - Simulated get
-    /**
-     * Get a policy by ID.
-     */
+    /** @returns 501 Not Implemented */
     async get(policyId) {
-        // MOCK - Returns simulated data
-        const mockPolicy = {
-            id: policyId,
-            name: "Block External Email",
-            description: "Prevent agents from sending external emails without approval",
-            type: "require_approval",
-            scope: "tenant",
-            conditions: [
-                { field: "action", operator: "eq", value: "send_email" },
-            ],
-            actions: [
-                { type: "require_approval" },
-            ],
-            priority: 100,
-            enabled: true,
-            created_at: new Date(Date.now() - 86400000).toISOString(),
-            updated_at: new Date().toISOString(),
-        };
-        return { data: mockPolicy, error: undefined, response: new Response() };
+        return notImplemented("get");
     }
-    // MOCK - Simulated create
-    /**
-     * Create a new policy.
-     */
+    /** @returns 501 Not Implemented */
     async create(body) {
-        // MOCK - Returns simulated data
-        const mockPolicy = {
-            id: `policy_${Date.now()}`,
-            name: body.name,
-            description: body.description,
-            type: body.type,
-            scope: body.scope,
-            scope_id: body.scope_id,
-            conditions: body.conditions,
-            actions: body.actions,
-            priority: body.priority || 50,
-            enabled: true,
-            created_at: new Date().toISOString(),
-            updated_at: new Date().toISOString(),
-        };
-        return { data: mockPolicy, error: undefined, response: new Response() };
-    }
-    // MOCK - Simulated update
-    /**
-     * Update a policy.
-     */
-    async update(policyId, body) {
-        // MOCK - Returns simulated data
-        const mockPolicy = {
-            id: policyId,
-            name: body.name || "Updated Policy",
-            type: body.type || "allow",
-            scope: body.scope || "tenant",
-            conditions: body.conditions || [],
-            actions: body.actions || [],
-            priority: body.priority || 50,
-            enabled: body.enabled ?? true,
-            created_at: new Date(Date.now() - 86400000).toISOString(),
-            updated_at: new Date().toISOString(),
-        };
-        return { data: mockPolicy, error: undefined, response: new Response() };
-    }
-    // MOCK - Simulated delete
-    /**
-     * Delete a policy.
-     */
-    async delete(policyId) {
-        // MOCK - Returns success
-        return { data: undefined, error: undefined, response: new Response() };
-    }
-    // MOCK - Simulated evaluate
-    /**
-     * Evaluate policies against an action (simulation).
-     */
-    async evaluate(input) {
-        // MOCK - Returns simulated evaluation
-        const mockResult = {
-            allowed: true,
-            matched_policies: ["policy_2"],
-            required_approvals: [],
-            warnings: [],
-            audit_entries: [
-                {
-                    policy_id: "policy_2",
-                    policy_name: "Audit All Tool Calls",
-                    decision: "allow",
-                    reason: "Action logged for audit",
-                    evaluated_at: new Date().toISOString(),
-                },
-            ],
-        };
-        return { data: mockResult, error: undefined, response: new Response() };
+        return notImplemented("create");
     }
-    // MOCK - Simulated enforce
-    /**
-     * Enforce policies (apply to current context).
-     */
-    async enforce(runId) {
-        // MOCK - Returns simulated enforcement
-        const mockResult = {
-            allowed: true,
-            matched_policies: [],
-            required_approvals: [],
-            warnings: [],
-            audit_entries: [],
-        };
-        return { data: mockResult, error: undefined, response: new Response() };
+    /** @returns 501 Not Implemented */
+    async evaluate(context) {
+        return notImplemented("evaluate");
     }
 }

package/dist/modules/runs.d.ts

@@ -15,7 +15,7 @@ type CancelRunResponse = components["schemas"]["CancelRunResponse"];
 type CheckpointListResponse = components["schemas"]["CheckpointListResponse"];
 export interface Run {
     run_id: string;
-    status: "pending" | "running" | "completed" | "failed" | "cancelled" | "waiting_input";
+    status: RunStatus;
     thread_id?: string;
     agent_id: string;
     agent_version_id?: string;
@@ -29,7 +29,13 @@ export interface Run {
     completed_at?: string;
     duration_ms?: number;
     reused?: boolean;
+    human_prompt?: string;
+    checkpoint_id?: string;
+    replayed_from_run_id?: string;
+    replayed_from_checkpoint_id?: string;
+    replay_mode?: "best_effort" | "strict";
 }
+export type RunStatus = "pending" | "queued" | "running" | "completed" | "failed" | "cancelled" | "waiting_for_human" | "resumed";
 export interface RunEvent {
     id: string;
     run_id: string;
@@ -45,6 +51,22 @@ export interface CreateRunResponse {
 }
 export type RunListResponse = PaginatedResponse<Run>;
 export type RunEventsResponse = PaginatedResponse<RunEvent>;
+/** Wave 2.3: Seq-based polling response for execution events */
+export interface RunEventsPollResponse {
+    events: RunEventDto[];
+    latest_seq: number;
+    next_after_seq: number;
+    has_more: boolean;
+}
+/** Single event from seq-based polling */
+export interface RunEventDto {
+    id: string;
+    seq: number;
+    type: string;
+    timestamp: string;
+    attempt_id: string;
+    payload: Record<string, unknown> | null;
+}
 export declare class RunsModule {
     private client;
     private baseUrl;
@@ -111,16 +133,55 @@ export declare class RunsModule {
     cancel(runId: string, reason?: string): Promise<APIResponse<CancelRunResponse>>;
     /**
      * Resume a run waiting for human input (HITL).
+     * After the run reaches status 'waiting_for_human', use this to provide
+     * the human response and continue execution.
+     *
+     * @param runId - The run ID to resume
+     * @param body - The human input to provide
+     * @returns Updated run (status will change to 'resumed' then 'queued')
+     *
+     * @example
+     * ```ts
+     * // List runs waiting for human input
+     * const waiting = await client.runs.list({ status: 'waiting_for_human' })
+     *
+     * // Get the prompt
+     * const run = await client.runs.get(runId)
+     * console.log(run.human_prompt)  // "Deseja continuar com a compra?"
+     *
+     * // Respond
+     * await client.runs.resume(runId, { input: { answer: "sim" } })
+     * ```
      */
-    resume(runId: string, input: unknown): Promise<APIResponse<Run>>;
+    resume(runId: string, body: {
+        input: unknown;
+    }): Promise<APIResponse<Run>>;
     /**
      * Rerun from start (stateless).
      */
     rerun(runId: string): Promise<APIResponse<CreateRunResponse>>;
     /**
      * Replay from checkpoint (stateful).
+     * Creates a NEW run that starts from the specified checkpoint.
+     *
+     * @param runId - The original run to replay from
+     * @param checkpointId - The checkpoint ID to start from
+     * @param options - Replay options
+     * @returns New run created from checkpoint
+     *
+     * @example
+     * ```ts
+     * const checkpoints = await client.runs.getCheckpoints(runId)
+     * const newRun = await client.runs.replay(runId, checkpoints[2].id, {
+     *   mode: 'best_effort',
+     *   reason: 'Debugging step 3'
+     * })
+     * ```
      */
-    replay(runId: string, checkpointId?: string, mode?: "best_effort" | "deterministic"): Promise<APIResponse<CreateRunResponse>>;
+    replay(runId: string, checkpointId?: string, options?: {
+        mode?: "best_effort" | "strict";
+        reason?: string;
+    }): Promise<APIResponse<CreateRunResponse>>;
     /**
      * Get run events for timeline (paged, no SSE).
      * @example
@@ -131,6 +192,31 @@ export declare class RunsModule {
     getEvents(runId: string, params?: PaginationParams): Promise<APIResponse<RunEventsResponse>>;
     /** Alias: runs.events() -> runs.getEvents() */
     events: (runId: string, params?: PaginationParams) => Promise<APIResponse<RunEventsResponse>>;
+    /**
+     * Wave 2.3: Seq-based event polling for execution trace.
+     * Use this for incremental polling with reconnection support.
+     *
+     * @param runId - Run ID to poll events for
+     * @param params - Polling options
+     * @returns Events with seq cursors for pagination
+     *
+     * @example
+     * ```ts
+     * let afterSeq = 0;
+     * while (run.status === 'running') {
+     *   const { data } = await client.runs.pollEvents(runId, { afterSeq });
+     *   for (const event of data.events) {
+     *     console.log(event.type, event.payload);
+     *   }
+     *   afterSeq = data.next_after_seq;
+     *   await sleep(1000);
+     * }
+     * ```
+     */
+    pollEvents(runId: string, params?: {
+        afterSeq?: number;
+        limit?: number;
+    }): Promise<APIResponse<RunEventsPollResponse>>;
     /**
      * Get checkpoints for a run.
      */

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

@@ -1 +1 @@
-{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../../src/modules/runs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../../src/modules/runs.ts"],"names":[],"mappings":"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"}

package/dist/modules/runs.js

@@ -82,11 +82,30 @@ export class RunsModule {
     }
     /**
      * Resume a run waiting for human input (HITL).
+     * After the run reaches status 'waiting_for_human', use this to provide
+     * the human response and continue execution.
+     *
+     * @param runId - The run ID to resume
+     * @param body - The human input to provide
+     * @returns Updated run (status will change to 'resumed' then 'queued')
+     *
+     * @example
+     * ```ts
+     * // List runs waiting for human input
+     * const waiting = await client.runs.list({ status: 'waiting_for_human' })
+     *
+     * // Get the prompt
+     * const run = await client.runs.get(runId)
+     * console.log(run.human_prompt)  // "Deseja continuar com a compra?"
+     *
+     * // Respond
+     * await client.runs.resume(runId, { input: { answer: "sim" } })
+     * ```
      */
-    async resume(runId, input) {
+    async resume(runId, body) {
         return this.client.POST("/v1/api/runs/{runId}/resume", {
             params: { path: { runId } },
-            body: { input },
+            body,
             headers: this.headers(),
         });
     }
@@ -101,11 +120,30 @@ export class RunsModule {
     }
     /**
      * Replay from checkpoint (stateful).
+     * Creates a NEW run that starts from the specified checkpoint.
+     *
+     * @param runId - The original run to replay from
+     * @param checkpointId - The checkpoint ID to start from
+     * @param options - Replay options
+     * @returns New run created from checkpoint
+     *
+     * @example
+     * ```ts
+     * const checkpoints = await client.runs.getCheckpoints(runId)
+     * const newRun = await client.runs.replay(runId, checkpoints[2].id, {
+     *   mode: 'best_effort',
+     *   reason: 'Debugging step 3'
+     * })
+     * ```
      */
-    async replay(runId, checkpointId, mode) {
+    async replay(runId, checkpointId, options) {
         return this.client.POST("/v1/api/runs/{runId}/replay", {
             params: { path: { runId } },
-            body: { checkpoint_id: checkpointId, mode },
+            body: {
+                checkpoint_id: checkpointId,
+                mode: options?.mode,
+                reason: options?.reason
+            },
             headers: this.headers(),
         });
     }
@@ -125,6 +163,39 @@ export class RunsModule {
     }
     /** Alias: runs.events() -> runs.getEvents() */
     events = (runId, params) => this.getEvents(runId, params);
+    /**
+     * Wave 2.3: Seq-based event polling for execution trace.
+     * Use this for incremental polling with reconnection support.
+     *
+     * @param runId - Run ID to poll events for
+     * @param params - Polling options
+     * @returns Events with seq cursors for pagination
+     *
+     * @example
+     * ```ts
+     * let afterSeq = 0;
+     * while (run.status === 'running') {
+     *   const { data } = await client.runs.pollEvents(runId, { afterSeq });
+     *   for (const event of data.events) {
+     *     console.log(event.type, event.payload);
+     *   }
+     *   afterSeq = data.next_after_seq;
+     *   await sleep(1000);
+     * }
+     * ```
+     */
+    async pollEvents(runId, params) {
+        return this.client.GET("/v1/api/runs/{runId}/events/stream", {
+            params: {
+                path: { runId },
+                query: {
+                    afterSeq: params?.afterSeq ?? 0,
+                    limit: params?.limit ?? 100
+                }
+            },
+            headers: this.headers(),
+        });
+    }
     // ======================== Checkpoints ========================
     /**
      * Get checkpoints for a run.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@agent-os-sdk/client",
-    "version": "0.1.2",
+    "version": "0.2.2",
     "description": "Official TypeScript SDK for Agent OS platform",
     "type": "module",
     "main": "./dist/index.js",