@renai-labs/sdk 0.1.9 → 0.1.10

package/dist/generated/types.gen.d.ts

@@ -273,6 +273,20 @@ export type Vault = {
     updatedAt: string;
     archivedAt: string | null;
 };
+export type ProjectEmailResponse = {
+    id: string;
+    orgId: string;
+    podId: string;
+    projectId: string;
+    defaultProjectAgentId: string | null;
+    fallbackSenderUserId: string | null;
+    localPart: string;
+    createdAt: string;
+    updatedAt: string;
+    archivedAt: string | null;
+    address: string;
+    projectName: string | null;
+};
 export type SlackChannel = {
     id: string;
     name: string;
@@ -334,66 +348,352 @@ export type CronTrigger = {
     updatedAt: string;
     archivedAt: string | null;
 };
+export type TopologyShare = {
+    id: string;
+    shareToken: string;
+    orgId: string;
+    userId: string | null;
+    createdAt: string;
+    updatedAt: string;
+    archivedAt: string | null;
+};
 export type Topology = {
-    surfaces: Array<{
+    meta: {
+        /**
+         * Org display name.
+         */
+        org: string;
+        /**
+         * Ren org id (org_…) this spec provisions into.
+         */
+        orgId: string;
+        /**
+         * Ren user id (usr_…) of the onboarding owner.
+         */
+        ownerUserId?: string;
+        /**
+         * Semver of this spec document.
+         */
+        specVersion?: string;
+        /**
+         * Date this spec was generated from live state.
+         */
+        snapshotDate?: string;
+        notes?: string;
+    };
+    agents: Array<{
+        /**
+         * A live Ren entity id (e.g. pod_…, prj_…, agt_…). Pins the spec entry to an existing row.
+         */
         id: string;
-        kind: "mcp" | "cron" | "webhook" | "slack" | "github";
+        /**
+         * Kebab-case slug used to reference an entity elsewhere in this spec.
+         */
+        slug: string;
         name: string;
+        /**
+         * Ren model id, e.g. opus-4-8, sonnet-4-6, haiku-4-5.
+         */
+        model?: string;
+        /**
+         * Visibility tier. Pods/projects/entities are created with the matching scope flag.
+         */
+        scope?: "org" | "user" | "registry";
+        /**
+         * Logo URL, for rendering.
+         */
         icon?: string;
-        tags: Array<string>;
-        ports: Array<{
-            id: string;
-            label: string;
-            targetProjectId: string;
-        }>;
-        vaultIds: Array<string>;
+        /**
+         * Pointer to the agent's system prompt (not inlined here).
+         */
+        promptRef?: string;
+        /**
+         * Skill slugs attached to this agent.
+         */
+        skills?: Array<string>;
+        /**
+         * MCP slugs wired to this agent.
+         */
+        mcps?: Array<string>;
+        notes?: string;
     }>;
-    pods: Array<{
+    mcps?: Array<{
+        /**
+         * A live Ren entity id (e.g. pod_…, prj_…, agt_…). Pins the spec entry to an existing row.
+         */
         id: string;
+        /**
+         * Kebab-case slug used to reference an entity elsewhere in this spec.
+         */
+        slug: string;
         name: string;
-        isPrivate: boolean;
+        /**
+         * Slug in the Ren MCP registry, if a registry MCP.
+         */
+        registrySlug?: string;
+        /**
+         * For a custom (non-registry) remote MCP server.
+         */
+        remoteUrl?: string;
+        auth?: "oauth" | "basic" | "api_key" | "none";
+        /**
+         * Slug of the credential this MCP needs.
+         */
+        credential?: string;
+        /**
+         * Logo URL, for rendering.
+         */
+        icon?: string;
+        /**
+         * Tag names, for rendering / filtering.
+         */
+        tags?: Array<string>;
+        notes?: string;
     }>;
-    projects: Array<{
+    skills?: Array<{
+        /**
+         * A live Ren entity id (e.g. pod_…, prj_…, agt_…). Pins the spec entry to an existing row.
+         */
         id: string;
-        podId: string;
+        /**
+         * Kebab-case slug used to reference an entity elsewhere in this spec.
+         */
+        slug: string;
+        source?: "registry" | "org" | "user";
+        notes?: string;
+    }>;
+    credentials?: Array<{
+        /**
+         * A live Ren entity id (e.g. pod_…, prj_…, agt_…). Pins the spec entry to an existing row.
+         */
+        id: string;
+        /**
+         * Kebab-case slug used to reference an entity elsewhere in this spec.
+         */
+        slug: string;
+        /**
+         * What the credential is for, e.g. "github", "apollo".
+         */
+        provider: string;
+        authType?: "oauth" | "basic" | "api_key" | "env";
+        /**
+         * Slug of the vault this credential lives in.
+         */
+        vault: string;
+        notes?: string;
+    }>;
+    vaults?: Array<{
+        /**
+         * A live Ren entity id (e.g. pod_…, prj_…, agt_…). Pins the spec entry to an existing row.
+         */
+        id: string;
+        /**
+         * Kebab-case slug used to reference an entity elsewhere in this spec.
+         */
+        slug: string;
         name: string;
-        agents: Array<{
-            id: string;
-            name: string;
-            icon?: string;
-            model?: string;
-        }>;
-        skillsCount: number;
+        /**
+         * Visibility tier. Pods/projects/entities are created with the matching scope flag.
+         */
+        scope: "org" | "user" | "registry";
+        /**
+         * Slugs of pods this vault attaches to.
+         */
+        attachedPods?: Array<string>;
+        notes?: string;
+    }>;
+    fileStores?: Array<{
+        /**
+         * A live Ren entity id (e.g. pod_…, prj_…, agt_…). Pins the spec entry to an existing row.
+         */
+        id: string;
+        /**
+         * Kebab-case slug used to reference an entity elsewhere in this spec.
+         */
+        slug: string;
+        name: string;
+        /**
+         * Visibility tier. Pods/projects/entities are created with the matching scope flag.
+         */
+        scope: "org" | "user" | "registry";
+        notes?: string;
     }>;
-    vaults: Array<{
+    memoryStores?: Array<{
+        /**
+         * A live Ren entity id (e.g. pod_…, prj_…, agt_…). Pins the spec entry to an existing row.
+         */
         id: string;
+        /**
+         * Kebab-case slug used to reference an entity elsewhere in this spec.
+         */
+        slug: string;
         name: string;
-        podIds: Array<string>;
-        credentials: Array<{
-            id: string;
-            label: string;
-            forSurfaceId?: string;
-            provider?: string;
-        }>;
+        /**
+         * Visibility tier. Pods/projects/entities are created with the matching scope flag.
+         */
+        scope: "org" | "user" | "registry";
+        notes?: string;
     }>;
-    stores: Array<{
+    pods: Array<{
+        /**
+         * A live Ren entity id (e.g. pod_…, prj_…, agt_…). Pins the spec entry to an existing row.
+         */
         id: string;
-        kind: "file" | "memory";
+        /**
+         * Kebab-case slug used to reference an entity elsewhere in this spec.
+         */
+        slug: string;
         name: string;
-        mounts: Array<{
-            projectId: string;
-        }>;
+        /**
+         * Visibility tier. Pods/projects/entities are created with the matching scope flag.
+         */
+        scope?: "org" | "user" | "registry";
+        /**
+         * Slugs of vaults attached to this pod (priority order).
+         */
+        vaults?: Array<string>;
+        notes?: string;
     }>;
-    env: {
+    projects: Array<{
+        /**
+         * A live Ren entity id (e.g. pod_…, prj_…, agt_…). Pins the spec entry to an existing row.
+         */
         id: string;
-    } | null;
-    edges: Array<{
+        /**
+         * Kebab-case slug used to reference an entity elsewhere in this spec.
+         */
+        slug: string;
+        name: string;
+        /**
+         * Slug of the pod this project lives in.
+         */
+        pod: string;
+        buildOrder?: number;
+        /**
+         * Slack channel name this project maps to.
+         */
+        slackChannel?: string;
+        /**
+         * Slug of the project's primary agent.
+         */
+        primaryAgent?: string;
+        subAgents?: Array<string>;
+        fileStores?: Array<string>;
+        memoryStores?: Array<string>;
+        restricted?: boolean;
+        requirements?: Array<{
+            /**
+             * Kebab-case slug used to reference an entity elsewhere in this spec.
+             */
+            id: string;
+            kind: "agent_attached" | "skill_attached" | "mcp_wired" | "credential_present" | "trigger_configured" | "slack_mapped" | "file_store_attached" | "memory_store_attached" | "vault_attached" | "capability" | "other";
+            /**
+             * Plain-language statement of exactly what must be true.
+             */
+            must: string;
+            /**
+             * Kebab-case slug used to reference an entity elsewhere in this spec.
+             */
+            agent?: string;
+            /**
+             * Kebab-case slug used to reference an entity elsewhere in this spec.
+             */
+            mcp?: string;
+            /**
+             * Kebab-case slug used to reference an entity elsewhere in this spec.
+             */
+            skill?: string;
+            /**
+             * Kebab-case slug used to reference an entity elsewhere in this spec.
+             */
+            credential?: string;
+            /**
+             * Kebab-case slug used to reference an entity elsewhere in this spec.
+             */
+            trigger?: string;
+            /**
+             * Kebab-case slug used to reference an entity elsewhere in this spec.
+             */
+            vault?: string;
+            /**
+             * Slug of the file/memory store this requirement is about.
+             */
+            store?: string;
+            channel?: string;
+            blocking?: boolean;
+            reason?: string;
+            /**
+             * Exact way to confirm it live via the ren CLI.
+             */
+            verify?: string;
+            blockedBy?: string;
+        }>;
+        notes?: string;
+    }>;
+    slack?: {
+        workspace?: string;
+        teamId?: string;
+        installationId?: string;
+        botUserId?: string;
+        channels: Array<{
+            /**
+             * Channel name including the leading #, e.g. "#bugs".
+             */
+            name: string;
+            id?: string;
+            /**
+             * Slug of the project this channel maps to, or null if unmapped.
+             */
+            project: string | null;
+        }>;
+    };
+    /**
+     * GitHub repos bound to projects. Non-native to the upstream spec; a first-class Ren concept.
+     */
+    github?: {
+        /**
+         * Ren GitHub installation id (ghi_…).
+         */
+        installationId?: string;
+        repos: Array<{
+            /**
+             * The owner/repo the agent works in.
+             */
+            name: string;
+            /**
+             * Slug of the project this repo is bound to.
+             */
+            project: string;
+            baseBranch?: string;
+        }>;
+    };
+    triggers?: Array<{
+        /**
+         * A live Ren entity id (e.g. pod_…, prj_…, agt_…). Pins the spec entry to an existing row.
+         */
         id: string;
-        kind: "route" | "state" | "cred";
-        sourceId: string;
-        sourcePortId?: string;
-        targetId: string;
-        targetCredId?: string;
+        /**
+         * Kebab-case slug used to reference an entity elsewhere in this spec.
+         */
+        slug: string;
+        /**
+         * Slug of the project whose primary agent this trigger fires.
+         */
+        project: string;
+        /**
+         * Cron expression, e.g. "0 9 * * 1".
+         */
+        schedule: string;
+        /**
+         * IANA tz, e.g. "Asia/Kolkata".
+         */
+        timezone?: string;
+        /**
+         * Fixed prompt delivered to the primary agent on each fire.
+         */
+        inputMessage: string;
+        enabled?: boolean;
+        notes?: string;
     }>;
 };
 export type SkillVersion = {
@@ -507,6 +807,9 @@ export type SessionMessagesPage = {
 };
 export type SessionUrlResponse = {
     url: string;
+    authedUrl: string;
+    serverPassword: string;
+    username: string;
 };
 export type OpencodeSession = {
     id: string;
@@ -1066,6 +1369,7 @@ export type AgentListData = {
         scope?: "user";
         limit?: number;
         offset?: number;
+        includeDeprecated?: boolean;
     };
     url: "/api/agents";
 };
@@ -1505,6 +1809,7 @@ export type AgentVersionListData = {
         scope?: "user";
         limit?: number;
         offset?: number;
+        includeDeprecated?: boolean;
     };
     url: "/api/agents/{id}/versions";
 };
@@ -1691,6 +1996,7 @@ export type BlueprintListData = {
         scope?: "user";
         limit?: number;
         offset?: number;
+        includeDeprecated?: boolean;
     };
     url: "/api/blueprints";
 };
@@ -2323,6 +2629,7 @@ export type EnvironmentListData = {
         orgId?: string;
         limit?: number;
         offset?: number;
+        includeDeprecated?: boolean;
         userId?: string | null;
     };
     url: "/api/environments";
@@ -2580,6 +2887,7 @@ export type FileStoreListData = {
         orgId?: string;
         limit?: number;
         offset?: number;
+        includeDeprecated?: boolean;
         userId?: string | null;
     };
     url: "/api/file-stores";
@@ -3418,6 +3726,7 @@ export type McpListData = {
         scope?: "user";
         limit?: number;
         offset?: number;
+        includeDeprecated?: boolean;
         sort?: "popular" | "trending" | "recent";
     };
     url: "/api/mcps";
@@ -4002,6 +4311,7 @@ export type MemoryStoreListData = {
         orgId?: string;
         limit?: number;
         offset?: number;
+        includeDeprecated?: boolean;
         userId?: string | null;
     };
     url: "/api/memory-stores";
@@ -4672,6 +4982,7 @@ export type PodListData = {
         orgId?: string;
         limit?: number;
         offset?: number;
+        includeDeprecated?: boolean;
         userId?: string | null;
     };
     url: "/api/pods";
@@ -5247,6 +5558,7 @@ export type ProjectListData = {
         scope?: "user";
         limit?: number;
         offset?: number;
+        includeDeprecated?: boolean;
         podId?: string;
     };
     url: "/api/projects";
@@ -6097,6 +6409,7 @@ export type ReplayListData = {
         scope?: "user";
         limit?: number;
         offset?: number;
+        includeDeprecated?: boolean;
         publisherId?: string;
     };
     url: "/api/replays";
@@ -6484,6 +6797,7 @@ export type SessionListData = {
         createdById?: string;
         limit?: number;
         offset?: number;
+        includeDeprecated?: boolean;
     };
     url: "/api/sessions";
 };
@@ -6929,6 +7243,7 @@ export type SkillListData = {
         scope?: "user";
         limit?: number;
         offset?: number;
+        includeDeprecated?: boolean;
         sort?: "popular" | "trending" | "recent";
     };
     url: "/api/skills";
@@ -7424,6 +7739,7 @@ export type SkillVersionListData = {
         scope?: "user";
         limit?: number;
         offset?: number;
+        includeDeprecated?: boolean;
     };
     url: "/api/skills/{id}/versions";
 };
@@ -7696,6 +8012,122 @@ export type TopologyGetResponses = {
     200: Topology;
 };
 export type TopologyGetResponse = TopologyGetResponses[keyof TopologyGetResponses];
+export type TopologyShareListData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Pass 'user' to scope the operation to the authenticated user's private namespace. Omit for the org-wide namespace.
+         */
+        scope?: "user";
+        limit?: number;
+        offset?: number;
+        includeDeprecated?: boolean;
+    };
+    url: "/api/topology-shares";
+};
+export type TopologyShareListErrors = {
+    /**
+     * Unauthorized
+     */
+    401: {
+        error: string;
+    };
+    /**
+     * Forbidden
+     */
+    403: {
+        error: string;
+    };
+};
+export type TopologyShareListError = TopologyShareListErrors[keyof TopologyShareListErrors];
+export type TopologyShareListResponses = {
+    /**
+     * List of topology shares
+     */
+    200: Array<TopologyShare>;
+};
+export type TopologyShareListResponse = TopologyShareListResponses[keyof TopologyShareListResponses];
+export type TopologyShareCreateData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Pass 'user' to scope the operation to the authenticated user's private namespace. Omit for the org-wide namespace.
+         */
+        scope?: "user";
+    };
+    url: "/api/topology-shares";
+};
+export type TopologyShareCreateErrors = {
+    /**
+     * Bad request
+     */
+    400: {
+        error: string;
+    };
+    /**
+     * Unauthorized
+     */
+    401: {
+        error: string;
+    };
+    /**
+     * Forbidden
+     */
+    403: {
+        error: string;
+    };
+};
+export type TopologyShareCreateError = TopologyShareCreateErrors[keyof TopologyShareCreateErrors];
+export type TopologyShareCreateResponses = {
+    /**
+     * Created topology share
+     */
+    200: TopologyShare;
+};
+export type TopologyShareCreateResponse = TopologyShareCreateResponses[keyof TopologyShareCreateResponses];
+export type TopologyShareArchiveData = {
+    body?: never;
+    path: {
+        id: string;
+    };
+    query?: {
+        /**
+         * Pass 'user' to scope the operation to the authenticated user's private namespace. Omit for the org-wide namespace.
+         */
+        scope?: "user";
+    };
+    url: "/api/topology-shares/{id}/archive";
+};
+export type TopologyShareArchiveErrors = {
+    /**
+     * Unauthorized
+     */
+    401: {
+        error: string;
+    };
+    /**
+     * Forbidden
+     */
+    403: {
+        error: string;
+    };
+    /**
+     * Not found
+     */
+    404: {
+        error: string;
+    };
+};
+export type TopologyShareArchiveError = TopologyShareArchiveErrors[keyof TopologyShareArchiveErrors];
+export type TopologyShareArchiveResponses = {
+    /**
+     * Archived topology share
+     */
+    200: TopologyShare;
+};
+export type TopologyShareArchiveResponse = TopologyShareArchiveResponses[keyof TopologyShareArchiveResponses];
 export type TriggerListData = {
     body?: never;
     path?: never;
@@ -7706,6 +8138,7 @@ export type TriggerListData = {
         scope?: "user";
         limit?: number;
         offset?: number;
+        includeDeprecated?: boolean;
         projectId: string;
     };
     url: "/api/triggers";
@@ -7941,6 +8374,7 @@ export type WebhookTriggerListData = {
         scope?: "user";
         limit?: number;
         offset?: number;
+        includeDeprecated?: boolean;
         projectId: string;
     };
     url: "/api/webhook-triggers";
@@ -8405,6 +8839,130 @@ export type SlackChannelSetResponses = {
     200: SlackInstallationResponse;
 };
 export type SlackChannelSetResponse = SlackChannelSetResponses[keyof SlackChannelSetResponses];
+export type EmailListData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Pass 'user' to scope the operation to the authenticated user's private namespace. Omit for the org-wide namespace.
+         */
+        scope?: "user";
+    };
+    url: "/api/emails";
+};
+export type EmailListErrors = {
+    /**
+     * Unauthorized
+     */
+    401: {
+        error: string;
+    };
+    /**
+     * Forbidden
+     */
+    403: {
+        error: string;
+    };
+};
+export type EmailListError = EmailListErrors[keyof EmailListErrors];
+export type EmailListResponses = {
+    /**
+     * Email mailboxes
+     */
+    200: Array<ProjectEmailResponse>;
+};
+export type EmailListResponse = EmailListResponses[keyof EmailListResponses];
+export type EmailUnsetData = {
+    body?: never;
+    path: {
+        projectId: string;
+    };
+    query?: {
+        /**
+         * Pass 'user' to scope the operation to the authenticated user's private namespace. Omit for the org-wide namespace.
+         */
+        scope?: "user";
+    };
+    url: "/api/emails/{projectId}";
+};
+export type EmailUnsetErrors = {
+    /**
+     * Unauthorized
+     */
+    401: {
+        error: string;
+    };
+    /**
+     * Forbidden
+     */
+    403: {
+        error: string;
+    };
+    /**
+     * Not found
+     */
+    404: {
+        error: string;
+    };
+};
+export type EmailUnsetError = EmailUnsetErrors[keyof EmailUnsetErrors];
+export type EmailUnsetResponses = {
+    /**
+     * Removed
+     */
+    204: void;
+};
+export type EmailUnsetResponse = EmailUnsetResponses[keyof EmailUnsetResponses];
+export type EmailSetData = {
+    body?: {
+        defaultProjectAgentId?: string | null;
+        fallbackSenderUserId?: string | null;
+    };
+    path: {
+        projectId: string;
+    };
+    query?: {
+        /**
+         * Pass 'user' to scope the operation to the authenticated user's private namespace. Omit for the org-wide namespace.
+         */
+        scope?: "user";
+    };
+    url: "/api/emails/{projectId}";
+};
+export type EmailSetErrors = {
+    /**
+     * Bad request
+     */
+    400: {
+        error: string;
+    };
+    /**
+     * Unauthorized
+     */
+    401: {
+        error: string;
+    };
+    /**
+     * Forbidden
+     */
+    403: {
+        error: string;
+    };
+    /**
+     * Not found
+     */
+    404: {
+        error: string;
+    };
+};
+export type EmailSetError = EmailSetErrors[keyof EmailSetErrors];
+export type EmailSetResponses = {
+    /**
+     * The project's email mailbox
+     */
+    200: ProjectEmailResponse;
+};
+export type EmailSetResponse = EmailSetResponses[keyof EmailSetResponses];
 export type VaultListData = {
     body?: never;
     path?: never;
@@ -8415,6 +8973,7 @@ export type VaultListData = {
         scope?: "user";
         limit?: number;
         offset?: number;
+        includeDeprecated?: boolean;
     };
     url: "/api/vaults";
 };
@@ -8668,6 +9227,7 @@ export type CredentialListData = {
         scope?: "user";
         limit?: number;
         offset?: number;
+        includeDeprecated?: boolean;
     };
     url: "/api/vaults/{vaultId}/credentials";
 };
@@ -9073,8 +9633,8 @@ export type RegistrySkillListData = {
     query?: {
         limit?: number;
         offset?: number;
-        sort?: "popular" | "trending" | "recent";
         includeDeprecated?: boolean;
+        sort?: "popular" | "trending" | "recent";
     };
     url: "/api/registry/skills";
 };
@@ -9124,8 +9684,8 @@ export type RegistryMcpListData = {
     query?: {
         limit?: number;
         offset?: number;
-        sort?: "popular" | "trending" | "recent";
         includeDeprecated?: boolean;
+        sort?: "popular" | "trending" | "recent";
     };
     url: "/api/registry/mcps";
 };
@@ -9316,3 +9876,27 @@ export type RegistryReplaySharedFilesPresignDownloadResponses = {
     200: ReplayPresignDownloadResponse;
 };
 export type RegistryReplaySharedFilesPresignDownloadResponse = RegistryReplaySharedFilesPresignDownloadResponses[keyof RegistryReplaySharedFilesPresignDownloadResponses];
+export type RegistryTopologyShareGetData = {
+    body?: never;
+    path: {
+        token: string;
+    };
+    query?: never;
+    url: "/api/registry/topology/share/{token}";
+};
+export type RegistryTopologyShareGetErrors = {
+    /**
+     * Not found
+     */
+    404: {
+        error: string;
+    };
+};
+export type RegistryTopologyShareGetError = RegistryTopologyShareGetErrors[keyof RegistryTopologyShareGetErrors];
+export type RegistryTopologyShareGetResponses = {
+    /**
+     * Live topology for the shared org
+     */
+    200: Topology;
+};
+export type RegistryTopologyShareGetResponse = RegistryTopologyShareGetResponses[keyof RegistryTopologyShareGetResponses];