@getpaseo/client 0.6.1 → 0.7.0-beta.2

package/dist/daemon-client.d.ts

@@ -2,7 +2,7 @@ import type { z } from "zod";
 import { type ClientCapability } from "@getpaseo/protocol/client-capabilities";
 import type { AgentAttentionNotificationPayload } from "@getpaseo/protocol/agent-attention-notification";
 import { AgentRefreshedStatusPayloadSchema, CheckoutRenameBranchResponseSchema, RenameTerminalResponseSchema, RestartRequestedStatusPayloadSchema, ShutdownRequestedStatusPayloadSchema, DaemonUpdateResponseSchema, type ActiveTurnBehavior, type ServerInfoStatusPayload } from "@getpaseo/protocol/messages";
-import type { AgentStreamEventPayload, AgentSnapshotPayload, ProjectPlacementPayload, AgentPermissionResolvedMessage, CreateAgentRequestMessage, CreatePaseoWorktreeRequest, FileDownloadTokenResponse, FileUploadResponse, FileExplorerResponse, FileVersion, FileWriteResult, FetchAgentTimelineResponseMessage, AgentForkContextResponseMessage, GitSetupOptions, CheckoutStatusResponse, CheckoutCommit, ParsedDiffFile, CheckoutCommitResponse, CheckoutMergeResponse, CheckoutMergeFromBaseResponse, CheckoutPullResponse, CheckoutPushResponse, CheckoutRefreshResponse, CheckoutPrCreateResponse, CheckoutPrMergeResponse, CheckoutPrMergeMethod, CheckoutForgeSetAutoMergeResponse, CheckoutGithubSetAutoMergeResponse, CheckoutForgeGetCheckDetailsResponse, CheckoutGithubGetCheckDetailsResponse, CheckoutPrStatusResponse, PullRequestTimelineResponse, CheckoutSwitchBranchResponse, StashSaveResponse, StashPopResponse, StashListResponse, ValidateBranchResponse, BranchSuggestionsResponse, ForgeSearchResponse, ForgeSearchRequest, GitHubSearchResponse, GitHubSearchRequest, DirectorySuggestionsResponse, PaseoWorktreeListResponse, PaseoWorktreeArchiveResponse, ProjectIconSource, ProjectIconResponse, ProjectIconGetResponse, ProjectAddResponse, ProjectCreateDirectoryResponse, OpenProjectResponseMessage, WorkspaceGithubSearchRepositoriesResponse, ProjectGithubCloneProtocol, ProjectGithubCloneResponse, ArchiveWorkspaceResponseMessage, WorkspaceSetupStatusResponseMessage, ListCommandsResponse, ListProviderFeaturesResponseMessage, ListProviderModelsResponseMessage, ListProviderModesResponseMessage, ListAvailableProvidersResponse, GetProvidersSnapshotResponseMessage, RefreshProvidersSnapshotResponseMessage, ProviderDiagnosticResponseMessage, ProviderUsageListResponseMessage, DaemonGetStatusResponse, DaemonGetPairingOfferResponse, DaemonConfigReloadResponse, DiagnosticsResponse, AgentRewindResponseMessage, ListTerminalsResponse, CreateTerminalResponse, SubscribeTerminalResponse, SubscribeTerminalRequest, CloseItemsResponse, KillTerminalResponse, CaptureTerminalResponse, TerminalInput, SessionInboundMessage, SessionOutboundMessage, SendAgentMessageRequest, PaseoConfigRaw, PaseoConfigRevision, WorkspaceCreateRequest, WorkspaceRecoveryState, PluginListItem, PluginLogEntry, AgentSkillSelection, AgentSkillsStatus, AgentSkillsSaveResult } from "@getpaseo/protocol/messages";
+import type { AgentStreamEventPayload, AgentSnapshotPayload, ProjectPlacementPayload, AgentPermissionResolvedMessage, CreateAgentRequestMessage, CreatePaseoWorktreeRequest, FileDownloadTokenResponse, FileUploadResponse, FileExplorerResponse, FileVersion, FileWriteResult, FetchAgentTimelineResponseMessage, AgentForkContextResponseMessage, GitSetupOptions, CheckoutStatusResponse, CheckoutCommit, ParsedDiffFile, CheckoutCommitResponse, CheckoutMergeResponse, CheckoutMergeFromBaseResponse, CheckoutPullResponse, CheckoutPushResponse, CheckoutRefreshResponse, CheckoutPrCreateResponse, CheckoutPrMergeResponse, CheckoutPrMergeMethod, CheckoutForgeSetAutoMergeResponse, CheckoutGithubSetAutoMergeResponse, CheckoutForgeGetCheckDetailsResponse, CheckoutGithubGetCheckDetailsResponse, CheckoutPrStatusResponse, PullRequestTimelineResponse, CheckoutSwitchBranchResponse, StashSaveResponse, StashPopResponse, StashListResponse, ValidateBranchResponse, BranchSuggestionsResponse, ForgeSearchResponse, ForgeSearchRequest, GitHubSearchResponse, GitHubSearchRequest, DirectorySuggestionsResponse, PaseoWorktreeListResponse, PaseoWorktreeArchiveResponse, ProjectIconSource, ProjectIconResponse, ProjectIconGetResponse, ProjectAddResponse, ProjectCreateDirectoryResponse, OpenProjectResponseMessage, WorkspaceGithubSearchRepositoriesResponse, ProjectGithubCloneProtocol, ProjectGithubCloneResponse, ArchiveWorkspaceResponseMessage, WorkspaceSetupStatusResponseMessage, ListCommandsResponse, ListProviderFeaturesResponseMessage, ListProviderModelsResponseMessage, ListProviderModesResponseMessage, ListAvailableProvidersResponse, GetProvidersSnapshotResponseMessage, RefreshProvidersSnapshotResponseMessage, ProviderDiagnosticResponseMessage, ProviderUsageListResponseMessage, DaemonGetStatusResponse, DaemonGetPairingOfferResponse, DaemonConfigReloadResponse, DiagnosticsResponse, AgentRewindResponseMessage, ListTerminalsResponse, CreateTerminalResponse, SubscribeTerminalResponse, SubscribeTerminalRequest, CloseItemsResponse, KillTerminalResponse, CaptureTerminalResponse, TerminalInput, SessionInboundMessage, SessionOutboundMessage, SendAgentMessageRequest, PaseoConfigRaw, PaseoConfigRevision, WorkspaceCreateRequest, WorkspaceRecoveryState, PluginListItem, PluginLogEntry, PluginSourceStatusItem, PluginSourceUpdateItem, AgentSkillSelection, AgentSkillsStatus, AgentSkillsSaveResult } from "@getpaseo/protocol/messages";
 import type { AgentPermissionRequest, AgentPermissionResponse, AgentPersistenceHandle, AgentProviderNotice, AgentProvider, AgentSessionConfig } from "@getpaseo/protocol/agent-types";
 import type { AgentConfigApply, MutableDaemonConfig, MutableDaemonConfigPatch } from "@getpaseo/protocol/messages";
 import { type DaemonTransportFactory, type WebSocketFactory } from "./daemon-client-transport.js";
@@ -1070,6 +1070,14 @@ export declare class DaemonClient {
         selection: AgentSkillSelection;
     }>;
     installDirectoryPlugin(path: string, id?: string): Promise<PluginListItem>;
+    installPluginSource(input: {
+        source: string;
+        id?: string;
+        ref?: string;
+        pluginPath?: string;
+    }): Promise<PluginListItem>;
+    getPluginSourceStatus(pluginId?: string): Promise<PluginSourceStatusItem[]>;
+    updatePluginSources(pluginId?: string): Promise<PluginSourceUpdateItem[]>;
     inspectDirectoryPlugin(path: string): Promise<{
         id: string;
     }>;

package/dist/daemon-client.js

@@ -3343,6 +3343,41 @@ export class DaemonClient {
         });
         return payload.plugin;
     }
+    async installPluginSource(input) {
+        const requestId = this.createRequestId();
+        const payload = await this.sendCorrelatedSessionRequest({
+            requestId,
+            message: { type: "plugin.source.install.request", requestId, ...input },
+            responseType: "plugin.source.install.response",
+        });
+        return payload.plugin;
+    }
+    async getPluginSourceStatus(pluginId) {
+        const requestId = this.createRequestId();
+        const payload = await this.sendCorrelatedSessionRequest({
+            requestId,
+            message: {
+                type: "plugin.source.status.request",
+                requestId,
+                ...(pluginId ? { pluginId } : {}),
+            },
+            responseType: "plugin.source.status.response",
+        });
+        return payload.plugins;
+    }
+    async updatePluginSources(pluginId) {
+        const requestId = this.createRequestId();
+        const payload = await this.sendCorrelatedSessionRequest({
+            requestId,
+            message: {
+                type: "plugin.source.update.request",
+                requestId,
+                ...(pluginId ? { pluginId } : {}),
+            },
+            responseType: "plugin.source.update.response",
+        });
+        return payload.plugins;
+    }
     async inspectDirectoryPlugin(path) {
         const requestId = this.createRequestId();
         return this.sendCorrelatedSessionRequest({

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import type { AgentSnapshotPayload, CreateAgentRequestMessage, FetchWorkspacesRequestMessage, FetchWorkspacesResponseMessage, GetProvidersSnapshotResponseMessage, ListAvailableProvidersResponse, ListProviderFeaturesRequestMessage, ListProviderFeaturesResponseMessage, ListProviderModelsResponseMessage, ListProviderModesResponseMessage, MutableDaemonConfig, MutableDaemonConfigPatch, ProviderDiagnosticResponseMessage, ProjectPlacementPayload, 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 = {
@@ -45,6 +45,11 @@ export interface PaseoClientConfig {
 export type PaseoWorkspace = WorkspaceDescriptorPayload;
 export type PaseoAgent = AgentSnapshotPayload;
 export type PaseoAgentListOptions = FetchAgentsOptions;
+export type PaseoProject = WorkspaceProjectDescriptorPayload;
+export type PaseoProjectListOptions = Omit<ProjectListRequestMessage, "type" | "requestId"> & {
+    requestId?: string;
+};
+export type PaseoProjectListResult = ProjectListResponseMessage["payload"];
 export interface PaseoAgentListResult {
     requestId: string;
     subscriptionId?: string | null;
@@ -102,6 +107,9 @@ export interface PaseoWorkspaceHandle {
      */
     subscribe(handler: (update: PaseoWorkspaceUpdate) => void): () => void;
 }
+export interface PaseoProjectActions {
+    list(options?: PaseoProjectListOptions): Promise<PaseoProjectListResult>;
+}
 export interface PaseoWorkspaceActions {
     list(options?: PaseoWorkspaceListOptions): Promise<PaseoWorkspaceListResult>;
     ref(workspace: string | PaseoWorkspace): PaseoWorkspaceHandle;
@@ -170,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"];
@@ -192,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>;
@@ -203,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;
     }>;
@@ -288,6 +324,7 @@ export interface PaseoConfigActions {
 }
 export interface PaseoApi {
     readonly workspaces: PaseoWorkspaceActions;
+    readonly projects: PaseoProjectActions;
     readonly agents: PaseoAgentActions;
     readonly providers: PaseoProviderActions;
     readonly config: PaseoConfigActions;

package/dist/index.js

@@ -43,6 +43,9 @@ export function createPaseoApi(daemonClient) {
     };
     const createWorkspaceHandle = createWorkspaceHandleFactory(daemonClient, createAgent);
     return {
+        projects: {
+            list: (options) => daemonClient.listProjects(options),
+        },
         workspaces: {
             list: (options) => daemonClient.fetchWorkspaces(options),
             ref: (workspace) => createWorkspaceHandle(workspace),
@@ -188,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 });
@@ -213,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.6.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.6.1",
-    "@getpaseo/relay": "0.6.1",
+    "@getpaseo/protocol": "0.7.0-beta.2",
+    "@getpaseo/relay": "0.7.0-beta.2",
     "zod": "^4.4.3"
   },
   "devDependencies": {