@getpaseo/client 0.7.0-beta.1 → 0.7.0-beta.3

package/dist/daemon-client.d.ts

@@ -103,7 +103,7 @@ export type BrowserAutomationExecuteResponseMessage = BrowserAutomationExecuteRe
 export interface DaemonClientConfig {
     url: string;
     clientId: string;
-    clientType?: "mobile" | "browser" | "cli" | "mcp";
+    clientType?: "mobile" | "browser" | "cli" | "mcp" | "hub";
     appVersion?: string;
     runtimeGeneration?: number | null;
     password?: string;
@@ -997,13 +997,27 @@ export declare class DaemonClient {
     }>;
     getDaemonStatus(options?: DaemonStatusOptions): Promise<DaemonStatusPayload>;
     reloadDaemonConfig(requestId?: string): Promise<DaemonConfigReloadResponse["payload"]>;
-    connectHub(hubUrl: string, token: string, requestId?: string): Promise<{
+    connectHub(hubUrl: string, token: string, permissions?: readonly string[], requestId?: string): Promise<{
         requestId: string;
         status: {
             state: "connecting" | "connected" | "not_connected" | "reconnecting" | "disconnecting" | "revoked";
             daemonId: string | null;
             hubOrigin: string | null;
-            scopes: string[];
+            permissions: ("daemon.read" | "daemon.manage" | "tunnel.manage" | "access.manage" | "workspace.read" | "workspace.write" | "workspace.manage" | "automation.manage" | "hub.execute")[];
+            connectedAt: string | null;
+            lastError: string | null;
+        };
+    }>;
+    updateHubPermissions(input: {
+        grant?: readonly string[];
+        revoke?: readonly string[];
+    }, requestId?: string): Promise<{
+        requestId: string;
+        status: {
+            state: "connecting" | "connected" | "not_connected" | "reconnecting" | "disconnecting" | "revoked";
+            daemonId: string | null;
+            hubOrigin: string | null;
+            permissions: ("daemon.read" | "daemon.manage" | "tunnel.manage" | "access.manage" | "workspace.read" | "workspace.write" | "workspace.manage" | "automation.manage" | "hub.execute")[];
             connectedAt: string | null;
             lastError: string | null;
         };
@@ -1014,7 +1028,7 @@ export declare class DaemonClient {
             state: "connecting" | "connected" | "not_connected" | "reconnecting" | "disconnecting" | "revoked";
             daemonId: string | null;
             hubOrigin: string | null;
-            scopes: string[];
+            permissions: ("daemon.read" | "daemon.manage" | "tunnel.manage" | "access.manage" | "workspace.read" | "workspace.write" | "workspace.manage" | "automation.manage" | "hub.execute")[];
             connectedAt: string | null;
             lastError: string | null;
         };
@@ -1025,7 +1039,7 @@ export declare class DaemonClient {
             state: "connecting" | "connected" | "not_connected" | "reconnecting" | "disconnecting" | "revoked";
             daemonId: string | null;
             hubOrigin: string | null;
-            scopes: string[];
+            permissions: ("daemon.read" | "daemon.manage" | "tunnel.manage" | "access.manage" | "workspace.read" | "workspace.write" | "workspace.manage" | "automation.manage" | "hub.execute")[];
             connectedAt: string | null;
             lastError: string | null;
         };

package/dist/daemon-client.js

@@ -3132,14 +3132,26 @@ export class DaemonClient {
             message: { type: "daemon.config.reload.request" },
         });
     }
-    async connectHub(hubUrl, token, requestId) {
+    async connectHub(hubUrl, token, permissions = [], requestId) {
         this.requireHubRelationshipSupport();
         return this.sendCorrelatedSessionRequest({
             requestId,
-            message: { type: "hub.management.daemon.connect.request", hubUrl, token },
+            message: { type: "hub.management.daemon.connect.request", hubUrl, token, permissions },
             responseType: "hub.management.daemon.connect.response",
         });
     }
+    async updateHubPermissions(input, requestId) {
+        this.requireHubRelationshipSupport();
+        return this.sendCorrelatedSessionRequest({
+            requestId,
+            message: {
+                type: "hub.management.daemon.permissions.update.request",
+                grant: input.grant ?? [],
+                revoke: input.revoke ?? [],
+            },
+            responseType: "hub.management.daemon.permissions.update.response",
+        });
+    }
     async getHubStatus(requestId) {
         this.requireHubRelationshipSupport();
         return this.sendCorrelatedSessionRequest({

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import type { AgentSnapshotPayload, CreateAgentRequestMessage, FetchWorkspacesRequestMessage, FetchWorkspacesResponseMessage, GetProvidersSnapshotResponseMessage, ListAvailableProvidersResponse, ListProviderFeaturesRequestMessage, ListProviderFeaturesResponseMessage, ListProviderModelsResponseMessage, ProjectListRequestMessage, ProjectListResponseMessage, ListProviderModesResponseMessage, MutableDaemonConfig, MutableDaemonConfigPatch, ProviderDiagnosticResponseMessage, ProjectPlacementPayload, WorkspaceProjectDescriptorPayload, RefreshProvidersSnapshotResponseMessage, SendAgentMessageRequest, SessionOutboundMessage, WorkspaceDescriptorPayload, WorkspaceCreateRequest } from "@getpaseo/protocol/messages";
+import type { AgentSnapshotPayload, CreateAgentRequestMessage, FetchWorkspacesRequestMessage, FetchWorkspacesResponseMessage, GetProvidersSnapshotResponseMessage, ListAvailableProvidersResponse, ListCommandsResponse, ListProviderFeaturesRequestMessage, ListProviderFeaturesResponseMessage, ListProviderModelsResponseMessage, ProjectListRequestMessage, ProjectListResponseMessage, ListProviderModesResponseMessage, MutableDaemonConfig, MutableDaemonConfigPatch, ProviderDiagnosticResponseMessage, ProjectPlacementPayload, WorkspaceProjectDescriptorPayload, RefreshProvidersSnapshotResponseMessage, SendAgentMessageRequest, SessionOutboundMessage, WorkspaceDescriptorPayload, WorkspaceCreateRequest } from "@getpaseo/protocol/messages";
 import { DaemonClient } from "./daemon-client.js";
 import type { FetchAgentsEntry, FetchAgentsOptions, FetchAgentsPageInfo, FetchAgentTimelineCursor, FetchAgentTimelineDirection, FetchAgentTimelinePayload, FetchAgentTimelineProjection, WaitForFinishResult } from "./daemon-client.js";
 export type ConnectionState = {
@@ -178,6 +178,10 @@ export interface PaseoAgentRunOptions extends PaseoAgentSendOptions {
     timeoutMs?: number;
 }
 export type PaseoAgentRunResult = WaitForFinishResult;
+export interface PaseoAgentCommandsOptions {
+    requestId?: string;
+}
+export type PaseoAgentCommandsResult = ListCommandsResponse["payload"];
 export type PaseoAgentUpdate = Extract<SessionOutboundMessage, {
     type: "agent_update";
 }>["payload"];
@@ -200,9 +204,25 @@ export interface PaseoAgentTimelineHandle {
 }
 export interface PaseoAgentHandle {
     readonly id: string;
+    /**
+     * `workspaceId` through `archivedAt` mirror the last snapshot this handle
+     * observed. A handle from `ref()` reads `null` for all of them until
+     * `refresh()`, `run()`, `waitForFinish()`, a timeline refetch, or
+     * `subscribe()` delivers a snapshot. Optional snapshot values also read as
+     * `null`; use `current()` when you need to distinguish those states.
+     */
     readonly workspaceId: string | null;
     readonly cwd: string | null;
     readonly status: PaseoAgent["status"] | null;
+    readonly capabilities: PaseoAgent["capabilities"] | null;
+    readonly availableModes: PaseoAgent["availableModes"] | null;
+    readonly pendingPermissions: PaseoAgent["pendingPermissions"] | null;
+    readonly activeTurn: NonNullable<PaseoAgent["activeTurn"]> | null;
+    readonly lastUsage: NonNullable<PaseoAgent["lastUsage"]> | null;
+    readonly lastError: NonNullable<PaseoAgent["lastError"]> | null;
+    readonly features: NonNullable<PaseoAgent["features"]> | null;
+    readonly runtimeInfo: NonNullable<PaseoAgent["runtimeInfo"]> | null;
+    readonly archivedAt: NonNullable<PaseoAgent["archivedAt"]> | null;
     readonly timeline: PaseoAgentTimelineHandle;
     current(): PaseoAgent | null;
     refresh(requestId?: string): Promise<PaseoAgentRefetchResult | null>;
@@ -211,6 +231,14 @@ export interface PaseoAgentHandle {
     run(text: string, options?: PaseoAgentRunOptions): Promise<PaseoAgentRunResult>;
     /** Waits for the current turn, including one started with `prompt`. */
     waitForFinish(timeoutMs?: number): Promise<PaseoAgentRunResult>;
+    /**
+     * Asks the running session for the slash commands and skills it actually
+     * loaded. Providers answer from the live session, so this sees built-in and
+     * bundled entries that no directory scan can find. The payload carries its own
+     * `error` string; a provider that cannot answer reports it there rather than
+     * rejecting.
+     */
+    commands(options?: PaseoAgentCommandsOptions): Promise<PaseoAgentCommandsResult>;
     archive(): Promise<{
         archivedAt: string;
     }>;

package/dist/index.js

@@ -191,6 +191,33 @@ function createAgentHandleFactory(daemonClient) {
             get status() {
                 return current?.status ?? null;
             },
+            get capabilities() {
+                return current?.capabilities ?? null;
+            },
+            get availableModes() {
+                return current?.availableModes ?? null;
+            },
+            get pendingPermissions() {
+                return current?.pendingPermissions ?? null;
+            },
+            get activeTurn() {
+                return current?.activeTurn ?? null;
+            },
+            get lastUsage() {
+                return current?.lastUsage ?? null;
+            },
+            get lastError() {
+                return current?.lastError ?? null;
+            },
+            get features() {
+                return current?.features ?? null;
+            },
+            get runtimeInfo() {
+                return current?.runtimeInfo ?? null;
+            },
+            get archivedAt() {
+                return current?.archivedAt ?? null;
+            },
             current: () => current,
             refresh: async (requestId) => {
                 const result = await daemonClient.fetchAgent({ agentId: id, requestId });
@@ -216,6 +243,7 @@ function createAgentHandleFactory(daemonClient) {
                 }
                 return result;
             },
+            commands: (options) => daemonClient.listCommands({ agentId: id, ...options }),
             archive: async () => {
                 const result = await daemonClient.archiveAgent(id);
                 if (current) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getpaseo/client",
-  "version": "0.7.0-beta.1",
+  "version": "0.7.0-beta.3",
   "description": "Paseo client SDK package",
   "files": [
     "dist",
@@ -39,8 +39,8 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@getpaseo/protocol": "0.7.0-beta.1",
-    "@getpaseo/relay": "0.7.0-beta.1",
+    "@getpaseo/protocol": "0.7.0-beta.3",
+    "@getpaseo/relay": "0.7.0-beta.3",
     "zod": "^4.4.3"
   },
   "devDependencies": {