@miosa/sdk 1.2.17 → 1.2.18

package/README.md

@@ -142,6 +142,29 @@ For platform agents that plan work outside the sandbox and then hand execution
 to a runtime inside the sandbox/computer, use the unified device API:
 
 ```ts
+await miosa.agentRuntimeProfiles.create({
+  workspaceId: "clinic-workspace",
+  name: "ClinicIQ Claude Code",
+  runtime: "claude-code",
+  isDefault: true,
+  connectors: [
+    "anthropic/cliniciq",
+    {
+      uid: "refero",
+      type: "mcp",
+      managed: true,
+      serverUrl: "https://api.refero.design/mcp",
+    },
+  ],
+  env: {
+    ANTHROPIC_API_KEY: "miosa-managed:anthropic/cliniciq",
+  },
+  metadata: {
+    model: "claude-opus-4.8",
+    whiteLabelClient: "cliniciq",
+  },
+});
+
 await miosa.devices.writeFile(sbx.id, {
   path: "/workspace/PLAN.md",
   content: "# Build plan\nUse the customer profile and export /workspace/out.",

package/dist/index.d.ts

@@ -425,6 +425,18 @@ declare class AgentRunGroups {
 }
 
 type AgentRuntime = "osa" | "codex" | "claude" | "claude-code" | "pi" | "hermes" | "custom";
+type AgentRuntimeConnector = string | {
+    uid?: string;
+    name?: string;
+    type?: "mcp" | "api-key" | "api_key" | "oauth" | "custom" | string;
+    provider?: string;
+    managed?: boolean;
+    server_url?: string;
+    serverUrl?: string;
+    scopes?: string[];
+    metadata?: Record<string, unknown>;
+    [key: string]: unknown;
+};
 interface AgentRuntimeProfile {
     id: string;
     tenant_id?: string;
@@ -439,7 +451,7 @@ interface AgentRuntimeProfile {
     applies_to?: Record<string, unknown>;
     appliesTo?: Record<string, unknown>;
     tools?: string[];
-    connectors?: string[];
+    connectors?: AgentRuntimeConnector[];
     env?: Record<string, string>;
     policy?: Record<string, unknown>;
     metadata?: Record<string, unknown>;
@@ -461,7 +473,7 @@ interface AgentRuntimeProfileParams {
     appliesTo?: Record<string, unknown>;
     applies_to?: Record<string, unknown>;
     tools?: string[];
-    connectors?: string[];
+    connectors?: AgentRuntimeConnector[];
     env?: Record<string, string>;
     policy?: Record<string, unknown>;
     metadata?: Record<string, unknown>;
@@ -3914,10 +3926,22 @@ interface DeviceExtendParams {
     timeoutSec?: number;
     timeout_sec?: number;
 }
+type DeviceConnectorBinding = string | {
+    uid?: string;
+    name?: string;
+    type?: "mcp" | "api-key" | "api_key" | "oauth" | "custom" | string;
+    provider?: string;
+    managed?: boolean;
+    server_url?: string;
+    serverUrl?: string;
+    scopes?: string[];
+    metadata?: Record<string, unknown>;
+    [key: string]: unknown;
+};
 interface DeviceBootstrapParams {
     runtime: "osa" | "claude-code" | "claude" | "codex" | "hermes" | "pi" | "custom" | string;
     cwd?: string;
-    connectors?: string[];
+    connectors?: DeviceConnectorBinding[];
     env?: Record<string, string>;
     mcp?: Array<{
         name: string;