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

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.2",
   "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.2",
+    "@getpaseo/relay": "0.7.0-beta.2",
     "zod": "^4.4.3"
   },
   "devDependencies": {