@agent-os-sdk/client 0.9.26 → 0.9.27

package/dist/modules/presets.js

@@ -0,0 +1,199 @@
+import { AgentsModule } from "./agents.js";
+import { TriggersModule } from "./triggers.js";
+const TRIGGER_TYPE_MAP = {
+    chatwoot: { type: "webhook", template_slug: "chatwoot" },
+    webhook: { type: "webhook", template_slug: "generic" },
+    schedule: { type: "schedule", template_slug: "cron" },
+};
+function buildAgentDefinitionId(name) {
+    const normalized = name
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, ".")
+        .replace(/\.{2,}/g, ".")
+        .replace(/^\.|\.$/g, "");
+    return `agent.${normalized || "untitled"}`;
+}
+function generateAgentIr(config) {
+    const agentDefinitionId = buildAgentDefinitionId(config.name);
+    const triggerLabel = config.trigger_type === "schedule" ? "Scheduled Trigger" : "Incoming Trigger";
+    const outputLabel = config.output_type === "chatwoot" ? "Chatwoot Output" : "HTTP Output";
+    return {
+        ir_version: "1.0",
+        agent_definition_id: agentDefinitionId,
+        version: "1.0.0",
+        metadata: {
+            name: config.name,
+            description: "Preset-generated agent_ir.v1 draft",
+        },
+        state_schema: {
+            type: "object",
+            properties: {
+                global: {
+                    type: "object",
+                },
+            },
+        },
+        inputs_schema: {
+            type: "object",
+            properties: {
+                message: {
+                    type: "string",
+                },
+            },
+            required: ["message"],
+        },
+        outputs_schema: {
+            type: "object",
+        },
+        outcome_schema: {
+            type: "object",
+            properties: {
+                preset_ready: {
+                    type: "boolean",
+                },
+            },
+            required: ["preset_ready"],
+        },
+        kpi_bindings: [
+            {
+                kpi_ref: `${agentDefinitionId}.preset_ready`,
+                source_scope: "outcome",
+                source_path: "preset_ready",
+            },
+        ],
+        evaluation_policy: {
+            execution_mode: "async",
+            evaluators: [
+                {
+                    evaluator_ref: `eval.${agentDefinitionId}.preset_shape_v1`,
+                    kind: "rule",
+                },
+            ],
+            sampling_policy: {
+                mode: "all",
+            },
+        },
+        improvement_policy_ref: null,
+        nodes: [
+            {
+                id: "start",
+                kind: "start",
+                capability_ref: "capability://agent-ir/start",
+                label: triggerLabel,
+                config: {},
+                bindings: {},
+                editability: { mode: "read_only" },
+            },
+            {
+                id: "draft_output",
+                kind: "end",
+                capability_ref: "capability://agent-ir/end",
+                label: outputLabel,
+                config: {},
+                bindings: {},
+                editability: { mode: "full" },
+            },
+        ],
+        edges: [
+            {
+                id: "edge_start_to_output",
+                from: "start",
+                to: "draft_output",
+                kind: "default",
+                priority: 0,
+            },
+        ],
+        capability_registry_refs: [],
+        policies: {},
+        editability: {
+            mode: "full",
+        },
+        entrypoints: ["start"],
+    };
+}
+function generateUUID() {
+    if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {
+        return crypto.randomUUID();
+    }
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (c) {
+        var r = Math.random() * 16 | 0, v = c == 'x' ? r : (r & 0x3 | 0x8);
+        return v.toString(16);
+    });
+}
+export class PresetsModule {
+    _client;
+    _headers;
+    // Internal modules needed for orchestration
+    _agents;
+    _triggers;
+    constructor(client, getHeaders) {
+        this._client = client;
+        this._headers = getHeaders;
+        this._agents = new AgentsModule(client, getHeaders);
+        this._triggers = new TriggersModule(client, getHeaders);
+    }
+    async createAgent(config) {
+        try {
+            console.log("[AgentOS SDK] Creating agent from preset...", {
+                name: config.name,
+                trigger_type: config.trigger_type,
+                output_type: config.output_type,
+            });
+            const { data: agent, error: createError } = await this._agents.create({
+                name: config.name,
+                idempotency_key: generateUUID()
+            });
+            if (createError || !agent) {
+                console.error("[AgentOS SDK] Failed to create agent:", createError);
+                return null;
+            }
+            const { error: draftError } = await this._agents.updateDraftIr(agent.id, generateAgentIr(config), { if_match: `"${agent.id}:0"` });
+            if (draftError) {
+                console.error("[AgentOS SDK] Failed to save agent_ir.v1 draft:", draftError);
+                return {
+                    agent_id: agent.id,
+                    agent_name: agent.name,
+                    status: "draft",
+                };
+            }
+            const { data: bundle, error: publishError } = await this._agents.publish(agent.id, {
+                set_as_live: true,
+                required_tools: [],
+                idempotency_key: generateUUID(),
+            });
+            if (publishError) {
+                console.error("[AgentOS SDK] Failed to publish bundle:", publishError);
+                return {
+                    agent_id: agent.id,
+                    agent_name: agent.name,
+                    status: "draft",
+                };
+            }
+            const triggerMapping = TRIGGER_TYPE_MAP[config.trigger_type] ?? TRIGGER_TYPE_MAP.webhook;
+            if (!triggerMapping)
+                throw new Error("Trigger mapping failed");
+            const { data: trigger, error: triggerError } = await this._triggers.create({
+                name: `${config.name} - ${config.trigger_type}`,
+                agent_id: agent.id,
+                trigger_type: triggerMapping.type,
+                template_slug: triggerMapping.template_slug,
+            });
+            if (triggerError) {
+                console.warn("[AgentOS SDK] Failed to create trigger:", triggerError);
+            }
+            return {
+                agent_id: agent.id,
+                agent_name: agent.name,
+                bundle_id: bundle?.id,
+                trigger_id: trigger?.id,
+                trigger_url: trigger?.invoke_url,
+                status: "live",
+            };
+        }
+        catch (err) {
+            console.error("[AgentOS SDK] Exception creating agent from preset:", err);
+            return null;
+        }
+    }
+}

package/dist/modules/prompts.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Prompts Module - Fully Typed
+ */
+import type { RawClient, APIResponse } from "../client/raw.js";
+export interface Prompt {
+    id: string;
+    name: string;
+    description?: string;
+    workspace_id: string;
+    tenant_id: string;
+    created_at: string;
+    updated_at: string;
+    versions?: PromptVersion[];
+}
+export interface PromptVersion {
+    id: string;
+    prompt_id: string;
+    version: number;
+    template: string;
+    input_schema?: Record<string, unknown>;
+    output_schema?: Record<string, unknown>;
+    is_live: boolean;
+    created_at: string;
+}
+export interface PromptListResponse {
+    items: Prompt[];
+    total: number;
+}
+export interface PromptVersionListResponse {
+    items: PromptVersion[];
+    total: number;
+}
+export interface RenderPromptResponse {
+    rendered: string;
+    input_used: Record<string, unknown>;
+}
+export declare class PromptsModule {
+    private client;
+    private headers;
+    constructor(client: RawClient, headers: () => Record<string, string>);
+    /**
+     * List all prompts.
+     */
+    list(params?: {
+        workspace_id?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<APIResponse<PromptListResponse>>;
+    /**
+     * Get a prompt by ID.
+     */
+    get(promptId: string): Promise<APIResponse<Prompt>>;
+    /**
+     * Create a new prompt.
+     */
+    create(body: {
+        name: string;
+        description?: string;
+        template?: string;
+        input_schema?: Record<string, unknown>;
+    }): Promise<APIResponse<Prompt>>;
+    /**
+     * Delete a prompt.
+     */
+    delete(promptId: string): Promise<APIResponse<void>>;
+    /**
+     * List all versions of a prompt.
+     */
+    listVersions(promptId: string): Promise<APIResponse<PromptVersionListResponse>>;
+    /**
+     * Create a new version.
+     */
+    createVersion(promptId: string, body: {
+        template: string;
+        input_schema?: Record<string, unknown>;
+        output_schema?: Record<string, unknown>;
+    }): Promise<APIResponse<PromptVersion>>;
+    /**
+     * Set the live version.
+     */
+    setLiveVersion(promptId: string, versionNumber: number): Promise<APIResponse<void>>;
+    /**
+     * Render a prompt with variables.
+     */
+    render(promptId: string, variables: Record<string, unknown>): Promise<APIResponse<RenderPromptResponse>>;
+}
+//# sourceMappingURL=prompts.d.ts.map

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

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

package/dist/modules/prompts.js

@@ -0,0 +1,87 @@
+/**
+ * Prompts Module - Fully Typed
+ */
+export class PromptsModule {
+    client;
+    headers;
+    constructor(client, headers) {
+        this.client = client;
+        this.headers = headers;
+    }
+    /**
+     * List all prompts.
+     */
+    async list(params) {
+        return this.client.GET("/v1/api/prompts", {
+            params: { query: params },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Get a prompt by ID.
+     */
+    async get(promptId) {
+        return this.client.GET("/v1/api/prompts/{id}", {
+            params: { path: { id: promptId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Create a new prompt.
+     */
+    async create(body) {
+        return this.client.POST("/v1/api/prompts", {
+            body,
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Delete a prompt.
+     */
+    async delete(promptId) {
+        return this.client.DELETE("/v1/api/prompts/{id}", {
+            params: { path: { id: promptId } },
+            headers: this.headers(),
+        });
+    }
+    // ======================== Versions ========================
+    /**
+     * List all versions of a prompt.
+     */
+    async listVersions(promptId) {
+        return this.client.GET("/v1/api/prompts/{id}/versions", {
+            params: { path: { id: promptId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Create a new version.
+     */
+    async createVersion(promptId, body) {
+        return this.client.POST("/v1/api/prompts/{id}/versions", {
+            params: { path: { id: promptId } },
+            body,
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Set the live version.
+     */
+    async setLiveVersion(promptId, versionNumber) {
+        return this.client.POST("/v1/api/prompts/{id}/set-live", {
+            params: { path: { id: promptId } },
+            body: { version_number: versionNumber },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Render a prompt with variables.
+     */
+    async render(promptId, variables) {
+        return this.client.POST("/v1/api/prompts/{id}/render", {
+            params: { path: { id: promptId } },
+            body: { variables },
+            headers: this.headers(),
+        });
+    }
+}

package/dist/modules/roles.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Roles Module — Tenant role and permission management.
+ *
+ * Endpoints: /v1/api/roles
+ */
+import type { RawClient, APIResponse } from "../client/raw.js";
+export interface TenantRole {
+    id: string;
+    name: string;
+    is_system: boolean;
+    permissions: string[];
+    created_at: string;
+    members_count: number;
+}
+export interface RoleListResponse {
+    items: TenantRole[];
+}
+export interface PermissionsListResponse {
+    items: string[];
+}
+export declare class RolesModule {
+    private client;
+    private headers;
+    constructor(client: RawClient, headers: () => Record<string, string>);
+    /**
+     * List all roles available in the tenant.
+     */
+    list(): Promise<APIResponse<RoleListResponse>>;
+    /**
+     * Get a specific role by ID.
+     */
+    get(roleId: string): Promise<APIResponse<TenantRole>>;
+    /**
+     * List all available system permissions.
+     */
+    getPermissions(): Promise<APIResponse<PermissionsListResponse>>;
+    /**
+     * Create a new custom role.
+     */
+    create(body: {
+        name: string;
+        permissions?: string[];
+    }): Promise<APIResponse<TenantRole>>;
+    /**
+     * Update an existing custom role.
+     * System roles cannot be updated.
+     */
+    update(roleId: string, body: {
+        name?: string;
+        permissions?: string[];
+    }): Promise<APIResponse<TenantRole>>;
+    /**
+     * Delete a custom role.
+     * System roles and roles assigned to members cannot be deleted.
+     */
+    delete(roleId: string): Promise<APIResponse<void>>;
+    /**
+     * Seed default permissions for all roles in the tenant.
+     */
+    seedDefaults(): Promise<APIResponse<{
+        message: string;
+    }>>;
+}
+//# sourceMappingURL=roles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"roles.d.ts","sourceRoot":"","sources":["../../src/modules/roles.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAM/D,MAAM,WAAW,UAAU;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,UAAU,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACpC,KAAK,EAAE,MAAM,EAAE,CAAC;CACnB;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,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;IAMpD;;OAEG;IACG,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAO3D;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,uBAAuB,CAAC,CAAC;IAMrE;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE;QACf,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;KAC1B,GAAG,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAOpC;;;OAGG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE;QAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;KAC1B,GAAG,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAQpC;;;OAGG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAOxD;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,WAAW,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAKlE"}

package/dist/modules/roles.js

@@ -0,0 +1,79 @@
+/**
+ * Roles Module — Tenant role and permission management.
+ *
+ * Endpoints: /v1/api/roles
+ */
+// =============================================================================
+// Module
+// =============================================================================
+export class RolesModule {
+    client;
+    headers;
+    constructor(client, headers) {
+        this.client = client;
+        this.headers = headers;
+    }
+    /**
+     * List all roles available in the tenant.
+     */
+    async list() {
+        return this.client.GET("/v1/api/roles", {
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Get a specific role by ID.
+     */
+    async get(roleId) {
+        return this.client.GET("/v1/api/roles/{id}", {
+            params: { path: { id: roleId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * List all available system permissions.
+     */
+    async getPermissions() {
+        return this.client.GET("/v1/api/roles/permissions", {
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Create a new custom role.
+     */
+    async create(body) {
+        return this.client.POST("/v1/api/roles", {
+            body,
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Update an existing custom role.
+     * System roles cannot be updated.
+     */
+    async update(roleId, body) {
+        return this.client.PUT("/v1/api/roles/{id}", {
+            params: { path: { id: roleId } },
+            body,
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Delete a custom role.
+     * System roles and roles assigned to members cannot be deleted.
+     */
+    async delete(roleId) {
+        return this.client.DELETE("/v1/api/roles/{id}", {
+            params: { path: { id: roleId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Seed default permissions for all roles in the tenant.
+     */
+    async seedDefaults() {
+        return this.client.POST("/v1/api/roles/seed-defaults", {
+            headers: this.headers(),
+        });
+    }
+}