Publish the TypeScript SDK and integration guides (#3141)
* feat(client): publish the TypeScript SDK surface Make the high-level client API usable for external integrations and document complete agent, workspace, provider, event, and recipe flows. * fix(client): correlate provider snapshots by daemon cwd Return the daemon's canonical snapshot identity so waitForReady can match updates for relative, tilde, and otherwise non-canonical paths without duplicating filesystem rules in the SDK. * test(server): make snapshot cwd assertion portable * fix(client): gate canonical provider snapshot waits Older daemons do not expose the canonical snapshot identity needed to correlate workspace updates safely. Require the advertised capability and fail with an update-host message instead of guessing across workspaces.
This commit is contained in:
Mohamed Boudra
+326
-121
@@ -17,24 +17,25 @@ import type {
|
||||
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 { DaemonClient };
|
||||
export type {
|
||||
DaemonClientConfig,
|
||||
DaemonEvent,
|
||||
BrowserAutomationExecuteRequestMessage,
|
||||
BrowserAutomationExecuteResponseMessage,
|
||||
WebSocketFactory,
|
||||
WebSocketLike,
|
||||
} from "./daemon-client.js";
|
||||
/**
|
||||
* Coding turns routinely run for minutes, so the handle waits far longer than
|
||||
* the transport's own conservative default.
|
||||
*/
|
||||
const DEFAULT_WAIT_FOR_FINISH_MS = 10 * 60_000;
|
||||
|
||||
export type ConnectionState =
|
||||
| { status: "idle" }
|
||||
@@ -75,6 +76,14 @@ export interface PaseoClientConfig {
|
||||
|
||||
export type PaseoWorkspace = WorkspaceDescriptorPayload;
|
||||
export type PaseoAgent = AgentSnapshotPayload;
|
||||
export type PaseoAgentListOptions = FetchAgentsOptions;
|
||||
|
||||
export interface PaseoAgentListResult {
|
||||
requestId: string;
|
||||
subscriptionId?: string | null;
|
||||
entries: FetchAgentsEntry[];
|
||||
pageInfo: FetchAgentsPageInfo;
|
||||
}
|
||||
export type PaseoWorkspaceListOptions = Omit<
|
||||
FetchWorkspacesRequestMessage,
|
||||
"type" | "requestId"
|
||||
@@ -94,11 +103,9 @@ export interface PaseoWorkspaceOpenOptions {
|
||||
requestId?: string;
|
||||
}
|
||||
|
||||
export interface PaseoWorkspaceOpenResult {
|
||||
requestId: string;
|
||||
workspace: PaseoWorkspaceHandle | null;
|
||||
error: string | null;
|
||||
}
|
||||
export type PaseoWorkspaceCreateOptions = Omit<WorkspaceCreateRequest, "type" | "requestId"> & {
|
||||
requestId?: string;
|
||||
};
|
||||
|
||||
export interface PaseoWorkspaceArchiveResult {
|
||||
requestId: string;
|
||||
@@ -114,19 +121,17 @@ export type PaseoWorkspaceUpdate = Extract<
|
||||
|
||||
export type PaseoWorkspaceUpdateHandler = (update: PaseoWorkspaceUpdate) => void;
|
||||
|
||||
/**
|
||||
* A handle is a stable typed reference to a daemon resource. Its identity is the
|
||||
* daemon id, and `latest()` only returns the most recent snapshot this handle has
|
||||
* seen through construction, `refetch()`, or this handle's local subscription.
|
||||
*/
|
||||
export interface PaseoWorkspaceHandle {
|
||||
readonly id: string;
|
||||
latest(): PaseoWorkspace | null;
|
||||
/**
|
||||
* Fetches a fresh workspace snapshot through the existing workspace list RPC,
|
||||
* exact-matches this handle id from the result, and updates `latest()`.
|
||||
*/
|
||||
refetch(options?: { requestId?: string }): Promise<PaseoWorkspace | null>;
|
||||
readonly projectId: string | null;
|
||||
readonly directory: string | null;
|
||||
readonly name: string | null;
|
||||
readonly status: PaseoWorkspace["status"] | null;
|
||||
readonly agents: {
|
||||
create(options: PaseoWorkspaceAgentCreateOptions): Promise<PaseoAgentHandle>;
|
||||
};
|
||||
current(): PaseoWorkspace | null;
|
||||
refresh(options?: { requestId?: string }): Promise<PaseoWorkspace | null>;
|
||||
archive(requestId?: string): Promise<PaseoWorkspaceArchiveResult>;
|
||||
/**
|
||||
* Subscribes to already-emitted daemon workspace_update events for this id.
|
||||
@@ -143,11 +148,8 @@ export interface PaseoWorkspaceActions {
|
||||
open(
|
||||
input: string | PaseoWorkspaceOpenOptions,
|
||||
requestId?: string,
|
||||
): Promise<PaseoWorkspaceOpenResult>;
|
||||
create(
|
||||
input: string | PaseoWorkspaceOpenOptions,
|
||||
requestId?: string,
|
||||
): Promise<PaseoWorkspaceOpenResult>;
|
||||
): Promise<PaseoWorkspaceHandle>;
|
||||
create(options: PaseoWorkspaceCreateOptions): Promise<PaseoWorkspaceHandle>;
|
||||
archive(
|
||||
workspace: string | PaseoWorkspaceHandle,
|
||||
requestId?: string,
|
||||
@@ -160,25 +162,43 @@ export interface PaseoWorkspaceActions {
|
||||
}
|
||||
|
||||
type PaseoAgentSessionConfig = CreateAgentRequestMessage["config"];
|
||||
type PaseoAgentProvider = PaseoAgentSessionConfig["provider"];
|
||||
type PaseoAgentConfigOverrides = Partial<Omit<PaseoAgentSessionConfig, "provider" | "cwd">>;
|
||||
export type PaseoAgentProvider = PaseoAgentSessionConfig["provider"];
|
||||
|
||||
export interface PaseoAgentCreateOptions extends PaseoAgentConfigOverrides {
|
||||
config?: PaseoAgentSessionConfig;
|
||||
provider?: CreateAgentRequestMessage["config"]["provider"];
|
||||
cwd?: string;
|
||||
workspaceId?: string;
|
||||
callerAgentId?: string;
|
||||
initialPrompt?: string;
|
||||
export type PaseoProviderFeatureValues = Record<string, unknown>;
|
||||
|
||||
export interface PaseoAgentConfig {
|
||||
/** Provider and model in `provider/model` format. */
|
||||
provider: string;
|
||||
modeId?: PaseoAgentSessionConfig["modeId"];
|
||||
thinkingOptionId?: PaseoAgentSessionConfig["thinkingOptionId"];
|
||||
featureValues?: PaseoProviderFeatureValues;
|
||||
/** JSON-safe provider-native settings, validated by the selected provider. */
|
||||
options?: PaseoAgentSessionConfig["providerOptions"];
|
||||
systemPrompt?: PaseoAgentSessionConfig["systemPrompt"];
|
||||
toolPolicy?: PaseoAgentSessionConfig["toolPolicy"];
|
||||
mcpServers?: PaseoAgentSessionConfig["mcpServers"];
|
||||
}
|
||||
|
||||
export interface PaseoAgentCreateOptions {
|
||||
config: PaseoAgentConfig;
|
||||
cwd: string;
|
||||
parent?: string | PaseoAgentHandle;
|
||||
title?: PaseoAgentSessionConfig["title"];
|
||||
env?: CreateAgentRequestMessage["env"];
|
||||
prompt?: string;
|
||||
clientMessageId?: string;
|
||||
outputSchema?: Record<string, unknown>;
|
||||
images?: CreateAgentRequestMessage["images"];
|
||||
attachments?: CreateAgentRequestMessage["attachments"];
|
||||
git?: CreateAgentRequestMessage["git"];
|
||||
worktree?: CreateAgentRequestMessage["worktree"];
|
||||
autoArchive?: CreateAgentRequestMessage["autoArchive"];
|
||||
requestId?: string;
|
||||
labels?: Record<string, string>;
|
||||
}
|
||||
|
||||
export type PaseoWorkspaceAgentCreateOptions = Omit<PaseoAgentCreateOptions, "cwd">;
|
||||
|
||||
export interface PaseoAgentRefetchResult {
|
||||
agent: PaseoAgent;
|
||||
project: ProjectPlacementPayload | null;
|
||||
@@ -198,6 +218,12 @@ export interface PaseoAgentSendOptions {
|
||||
attachments?: SendAgentMessageRequest["attachments"];
|
||||
}
|
||||
|
||||
export interface PaseoAgentRunOptions extends PaseoAgentSendOptions {
|
||||
timeoutMs?: number;
|
||||
}
|
||||
|
||||
export type PaseoAgentRunResult = WaitForFinishResult;
|
||||
|
||||
export type PaseoAgentUpdate = Extract<SessionOutboundMessage, { type: "agent_update" }>["payload"];
|
||||
|
||||
export type PaseoAgentStream = Extract<SessionOutboundMessage, { type: "agent_stream" }>["payload"];
|
||||
@@ -207,8 +233,8 @@ export type PaseoAgentUpdateHandler = (update: PaseoAgentUpdate) => void;
|
||||
export interface PaseoAgentTimelineHandle {
|
||||
/**
|
||||
* Fetches a fresh timeline page through the existing daemon RPC. If the daemon
|
||||
* includes an agent snapshot in the response, the parent handle's `latest()`
|
||||
* is updated to that snapshot.
|
||||
* includes an agent snapshot in the response, the parent handle is updated to
|
||||
* that value.
|
||||
*/
|
||||
refetch(options?: PaseoAgentTimelineRefetchOptions): Promise<FetchAgentTimelinePayload>;
|
||||
/**
|
||||
@@ -218,24 +244,26 @@ export interface PaseoAgentTimelineHandle {
|
||||
subscribe(handler: (event: PaseoAgentStream) => void): () => void;
|
||||
}
|
||||
|
||||
/**
|
||||
* Agent handles follow the same identity/snapshot rule as workspace handles:
|
||||
* `id` is stable, while `latest()` is only the newest snapshot observed by this
|
||||
* handle through construction, `refetch()`, timeline refetch, archive, or local
|
||||
* agent_update subscription.
|
||||
*/
|
||||
export interface PaseoAgentHandle {
|
||||
readonly id: string;
|
||||
readonly workspaceId: string | null;
|
||||
readonly cwd: string | null;
|
||||
readonly status: PaseoAgent["status"] | null;
|
||||
readonly timeline: PaseoAgentTimelineHandle;
|
||||
latest(): PaseoAgent | null;
|
||||
refetch(requestId?: string): Promise<PaseoAgentRefetchResult | null>;
|
||||
current(): PaseoAgent | null;
|
||||
refresh(requestId?: string): Promise<PaseoAgentRefetchResult | null>;
|
||||
send(text: string, options?: PaseoAgentSendOptions): Promise<void>;
|
||||
/** Sends a prompt and resolves when that turn finishes or needs attention. */
|
||||
run(text: string, options?: PaseoAgentRunOptions): Promise<PaseoAgentRunResult>;
|
||||
/** Waits for the current turn, including one started with `prompt`. */
|
||||
waitForFinish(timeoutMs?: number): Promise<PaseoAgentRunResult>;
|
||||
archive(): Promise<{ archivedAt: string }>;
|
||||
detach(): Promise<void>;
|
||||
subscribe(handler: (update: PaseoAgentUpdate) => void): () => void;
|
||||
}
|
||||
|
||||
export interface PaseoAgentActions {
|
||||
list(options?: PaseoAgentListOptions): Promise<PaseoAgentListResult>;
|
||||
ref(agent: string | PaseoAgent): PaseoAgentHandle;
|
||||
create(options: PaseoAgentCreateOptions): Promise<PaseoAgentHandle>;
|
||||
/**
|
||||
@@ -245,21 +273,16 @@ export interface PaseoAgentActions {
|
||||
subscribe(handler: PaseoAgentUpdateHandler): () => void;
|
||||
}
|
||||
|
||||
export interface PaseoProviderConfig extends PaseoProviderConfigInput {
|
||||
provider: PaseoAgentProvider;
|
||||
}
|
||||
export type PaseoProviderFeatureValues = Record<string, unknown>;
|
||||
|
||||
export interface PaseoProviderConfigInput {
|
||||
model?: string;
|
||||
modeId?: string;
|
||||
thinkingOptionId?: string;
|
||||
featureValues?: PaseoProviderFeatureValues;
|
||||
}
|
||||
|
||||
export type PaseoProviderModelsResult = ListProviderModelsResponseMessage["payload"];
|
||||
export type PaseoProviderModesResult = ListProviderModesResponseMessage["payload"];
|
||||
export type PaseoProviderFeaturesInput = ListProviderFeaturesRequestMessage["draftConfig"];
|
||||
type PaseoProviderFeaturesDraft = ListProviderFeaturesRequestMessage["draftConfig"];
|
||||
export interface PaseoProviderFeaturesInput extends Omit<
|
||||
PaseoProviderFeaturesDraft,
|
||||
"provider" | "model"
|
||||
> {
|
||||
/** Provider and model in `provider/model` format. */
|
||||
provider: string;
|
||||
}
|
||||
export type PaseoProviderFeaturesResult = ListProviderFeaturesResponseMessage["payload"];
|
||||
export type PaseoProviderAvailabilityResult = ListAvailableProvidersResponse["payload"];
|
||||
export type PaseoProviderSnapshotResult = GetProvidersSnapshotResponseMessage["payload"];
|
||||
@@ -281,12 +304,11 @@ export interface PaseoProviderRefreshOptions {
|
||||
requestId?: string;
|
||||
}
|
||||
|
||||
export interface PaseoProviderWaitOptions extends PaseoProviderListOptions {
|
||||
timeoutMs?: number;
|
||||
}
|
||||
|
||||
export interface PaseoProviderActions {
|
||||
codex(input?: PaseoProviderConfigInput): PaseoProviderConfig;
|
||||
claude(input?: PaseoProviderConfigInput): PaseoProviderConfig;
|
||||
opencode(input?: PaseoProviderConfigInput): PaseoProviderConfig;
|
||||
copilot(input?: PaseoProviderConfigInput): PaseoProviderConfig;
|
||||
config(provider: PaseoAgentProvider, input?: PaseoProviderConfigInput): PaseoProviderConfig;
|
||||
listModels(
|
||||
provider: PaseoAgentProvider,
|
||||
options?: PaseoProviderListOptions,
|
||||
@@ -301,6 +323,8 @@ export interface PaseoProviderActions {
|
||||
): Promise<PaseoProviderFeaturesResult>;
|
||||
listAvailable(options?: { requestId?: string }): Promise<PaseoProviderAvailabilityResult>;
|
||||
snapshot(options?: PaseoProviderListOptions): Promise<PaseoProviderSnapshotResult>;
|
||||
/** Resolves after the daemon's lazy provider discovery has finished. */
|
||||
waitForReady(options?: PaseoProviderWaitOptions): Promise<PaseoProviderSnapshotResult>;
|
||||
refresh(options?: PaseoProviderRefreshOptions): Promise<PaseoProviderRefreshResult>;
|
||||
diagnostic(
|
||||
provider: PaseoAgentProvider,
|
||||
@@ -346,8 +370,32 @@ export function createPaseoClient(config: PaseoClientConfig): PaseoClient {
|
||||
clientId: config.clientId ?? createGeneratedClientId(),
|
||||
clientType: "cli",
|
||||
});
|
||||
const createWorkspaceHandle = createWorkspaceHandleFactory(daemonClient);
|
||||
const createAgentHandle = createAgentHandleFactory(daemonClient);
|
||||
const createAgent = async (
|
||||
options: PaseoAgentCreateOptions,
|
||||
placement?: { workspaceId: string; cwd: string },
|
||||
) => {
|
||||
const { config: agentConfig, cwd, parent, title, prompt, ...requestOptions } = options;
|
||||
const { provider: providerModel, options: providerOptions, ...runtimeConfig } = agentConfig;
|
||||
const { provider, model } = parseProviderModel(providerModel);
|
||||
const effectiveCwd = placement?.cwd ?? cwd;
|
||||
const agent = await daemonClient.createAgent({
|
||||
...requestOptions,
|
||||
config: {
|
||||
...runtimeConfig,
|
||||
provider,
|
||||
model,
|
||||
cwd: effectiveCwd,
|
||||
...(title !== undefined ? { title } : {}),
|
||||
...(providerOptions !== undefined ? { providerOptions } : {}),
|
||||
},
|
||||
...(placement ? { workspaceId: placement.workspaceId } : {}),
|
||||
...(parent ? { callerAgentId: resolveAgentId(parent) } : {}),
|
||||
...(prompt !== undefined ? { initialPrompt: prompt } : {}),
|
||||
});
|
||||
return createAgentHandle(agent);
|
||||
};
|
||||
const createWorkspaceHandle = createWorkspaceHandleFactory(daemonClient, createAgent);
|
||||
|
||||
return {
|
||||
workspaces: {
|
||||
@@ -355,8 +403,13 @@ export function createPaseoClient(config: PaseoClientConfig): PaseoClient {
|
||||
ref: (workspace) => createWorkspaceHandle(workspace),
|
||||
open: (input, requestId) =>
|
||||
openWorkspace(daemonClient, createWorkspaceHandle, input, requestId),
|
||||
create: (input, requestId) =>
|
||||
openWorkspace(daemonClient, createWorkspaceHandle, input, requestId),
|
||||
create: async ({ requestId, ...options }) => {
|
||||
const result = await daemonClient.createWorkspace(options, requestId);
|
||||
if (result.error || !result.workspace) {
|
||||
throw new Error(result.error ?? "The daemon did not create a workspace");
|
||||
}
|
||||
return createWorkspaceHandle(result.workspace);
|
||||
},
|
||||
archive: (workspace, requestId) =>
|
||||
daemonClient.archiveWorkspace(resolveWorkspaceId(workspace), requestId),
|
||||
subscribe: (handler) =>
|
||||
@@ -365,28 +418,24 @@ export function createPaseoClient(config: PaseoClientConfig): PaseoClient {
|
||||
}),
|
||||
},
|
||||
agents: {
|
||||
list: (options) => daemonClient.fetchAgents(options),
|
||||
ref: (agent) => createAgentHandle(agent),
|
||||
create: async (options) => {
|
||||
const agent = await daemonClient.createAgent(options);
|
||||
return createAgentHandle(agent);
|
||||
},
|
||||
create: (options) => createAgent(options),
|
||||
subscribe: (handler) =>
|
||||
daemonClient.on("agent_update", (message) => {
|
||||
handler(message.payload);
|
||||
}),
|
||||
},
|
||||
providers: {
|
||||
codex: (input) => providerConfig("codex", input),
|
||||
claude: (input) => providerConfig("claude", input),
|
||||
opencode: (input) => providerConfig("opencode", input),
|
||||
copilot: (input) => providerConfig("copilot", input),
|
||||
config: (provider, input) => providerConfig(provider, input),
|
||||
listModels: (provider, options) => daemonClient.listProviderModels(provider, options),
|
||||
listModes: (provider, options) => daemonClient.listProviderModes(provider, options),
|
||||
listFeatures: (draftConfig, options) =>
|
||||
daemonClient.listProviderFeatures(draftConfig, options),
|
||||
listFeatures: ({ provider: providerModel, ...draftConfig }, options) => {
|
||||
const { provider, model } = parseProviderModel(providerModel);
|
||||
return daemonClient.listProviderFeatures({ ...draftConfig, provider, model }, options);
|
||||
},
|
||||
listAvailable: (options) => daemonClient.listAvailableProviders(options),
|
||||
snapshot: (options) => daemonClient.getProvidersSnapshot(options),
|
||||
waitForReady: (options) => waitForProvidersReady(daemonClient, options),
|
||||
refresh: (options) => daemonClient.refreshProvidersSnapshot(options),
|
||||
diagnostic: (provider, options) => daemonClient.getProviderDiagnostic(provider, options),
|
||||
subscribe: (handler) =>
|
||||
@@ -407,30 +456,71 @@ export function createPaseoClient(config: PaseoClientConfig): PaseoClient {
|
||||
|
||||
type WorkspaceHandleFactory = (workspace: string | PaseoWorkspace) => PaseoWorkspaceHandle;
|
||||
type AgentHandleFactory = (agent: string | PaseoAgent) => PaseoAgentHandle;
|
||||
type CreateAgent = (
|
||||
options: PaseoAgentCreateOptions,
|
||||
placement?: { workspaceId: string; cwd: string },
|
||||
) => Promise<PaseoAgentHandle>;
|
||||
|
||||
function createWorkspaceHandleFactory(daemonClient: DaemonClient): WorkspaceHandleFactory {
|
||||
function createWorkspaceHandleFactory(
|
||||
daemonClient: DaemonClient,
|
||||
createAgent: CreateAgent,
|
||||
): WorkspaceHandleFactory {
|
||||
return (workspace) => {
|
||||
const id = typeof workspace === "string" ? workspace : workspace.id;
|
||||
let latest = typeof workspace === "string" ? null : workspace;
|
||||
let current = typeof workspace === "string" ? null : workspace;
|
||||
|
||||
const refresh = async (options?: { requestId?: string }) => {
|
||||
let cursor: string | undefined;
|
||||
let requestId = options?.requestId;
|
||||
do {
|
||||
const result = await daemonClient.fetchWorkspaces({
|
||||
requestId,
|
||||
page: { limit: 200, ...(cursor ? { cursor } : {}) },
|
||||
});
|
||||
const match = result.entries.find((entry) => entry.id === id);
|
||||
if (match) {
|
||||
current = match;
|
||||
return current;
|
||||
}
|
||||
cursor = result.pageInfo.nextCursor ?? undefined;
|
||||
requestId = undefined;
|
||||
} while (cursor);
|
||||
current = null;
|
||||
return current;
|
||||
};
|
||||
|
||||
return {
|
||||
id,
|
||||
latest: () => latest,
|
||||
refetch: async (options) => {
|
||||
// Best-effort: fetches one page and matches by id client-side, so a workspace beyond
|
||||
// the first page won't be found. TODO: add a "get workspace by id" lookup and resolve
|
||||
// by exact id instead of paging.
|
||||
const result = await daemonClient.fetchWorkspaces({
|
||||
requestId: options?.requestId,
|
||||
page: { limit: 25 },
|
||||
});
|
||||
latest = result.entries.find((entry) => entry.id === id) ?? null;
|
||||
return latest;
|
||||
get projectId() {
|
||||
return current?.projectId ?? null;
|
||||
},
|
||||
get directory() {
|
||||
return current?.workspaceDirectory ?? null;
|
||||
},
|
||||
get name() {
|
||||
return current?.name ?? null;
|
||||
},
|
||||
get status() {
|
||||
return current?.status ?? null;
|
||||
},
|
||||
agents: {
|
||||
create: async (options) => {
|
||||
const snapshot = current ?? (await refresh());
|
||||
if (!snapshot?.workspaceDirectory) {
|
||||
throw new Error(`Workspace ${id} has no available directory`);
|
||||
}
|
||||
return createAgent(
|
||||
{ ...options, cwd: snapshot.workspaceDirectory },
|
||||
{ workspaceId: id, cwd: snapshot.workspaceDirectory },
|
||||
);
|
||||
},
|
||||
},
|
||||
current: () => current,
|
||||
refresh,
|
||||
archive: async (requestId) => {
|
||||
const result = await daemonClient.archiveWorkspace(id, requestId);
|
||||
if (latest) {
|
||||
latest = { ...latest, archivingAt: result.archivedAt };
|
||||
if (current) {
|
||||
current = { ...current, archivingAt: result.archivedAt };
|
||||
}
|
||||
return result;
|
||||
},
|
||||
@@ -438,11 +528,11 @@ function createWorkspaceHandleFactory(daemonClient: DaemonClient): WorkspaceHand
|
||||
daemonClient.on("workspace_update", (message) => {
|
||||
const update = message.payload;
|
||||
if (update.kind === "upsert" && update.workspace.id === id) {
|
||||
latest = update.workspace;
|
||||
current = update.workspace;
|
||||
handler(update);
|
||||
}
|
||||
if (update.kind === "remove" && update.id === id) {
|
||||
latest = null;
|
||||
current = null;
|
||||
handler(update);
|
||||
}
|
||||
}),
|
||||
@@ -453,7 +543,7 @@ function createWorkspaceHandleFactory(daemonClient: DaemonClient): WorkspaceHand
|
||||
function createAgentHandleFactory(daemonClient: DaemonClient): AgentHandleFactory {
|
||||
return (agent) => {
|
||||
const id = typeof agent === "string" ? agent : agent.id;
|
||||
let latest = typeof agent === "string" ? null : agent;
|
||||
let current = typeof agent === "string" ? null : agent;
|
||||
|
||||
const handle: PaseoAgentHandle = {
|
||||
id,
|
||||
@@ -461,7 +551,7 @@ function createAgentHandleFactory(daemonClient: DaemonClient): AgentHandleFactor
|
||||
refetch: async (options) => {
|
||||
const result = await daemonClient.fetchAgentTimeline(id, options);
|
||||
if (result.agent) {
|
||||
latest = result.agent;
|
||||
current = result.agent;
|
||||
}
|
||||
return result;
|
||||
},
|
||||
@@ -472,19 +562,50 @@ function createAgentHandleFactory(daemonClient: DaemonClient): AgentHandleFactor
|
||||
}
|
||||
}),
|
||||
},
|
||||
latest: () => latest,
|
||||
refetch: async (requestId) => {
|
||||
get workspaceId() {
|
||||
return current?.workspaceId ?? null;
|
||||
},
|
||||
get cwd() {
|
||||
return current?.cwd ?? null;
|
||||
},
|
||||
get status() {
|
||||
return current?.status ?? null;
|
||||
},
|
||||
current: () => current,
|
||||
refresh: async (requestId) => {
|
||||
const result = await daemonClient.fetchAgent({ agentId: id, requestId });
|
||||
latest = result?.agent ?? null;
|
||||
current = result?.agent ?? null;
|
||||
return result;
|
||||
},
|
||||
send: async (text, options) => {
|
||||
await daemonClient.sendAgentMessage(id, text, options);
|
||||
},
|
||||
run: async (text, options) => {
|
||||
const { timeoutMs, ...sendOptions } = options ?? {};
|
||||
await daemonClient.sendAgentMessage(id, text, sendOptions);
|
||||
const result = await daemonClient.waitForFinish(
|
||||
id,
|
||||
timeoutMs ?? DEFAULT_WAIT_FOR_FINISH_MS,
|
||||
);
|
||||
if (result.final) {
|
||||
current = result.final;
|
||||
}
|
||||
return result;
|
||||
},
|
||||
waitForFinish: async (timeoutMs) => {
|
||||
const result = await daemonClient.waitForFinish(
|
||||
id,
|
||||
timeoutMs ?? DEFAULT_WAIT_FOR_FINISH_MS,
|
||||
);
|
||||
if (result.final) {
|
||||
current = result.final;
|
||||
}
|
||||
return result;
|
||||
},
|
||||
archive: async () => {
|
||||
const result = await daemonClient.archiveAgent(id);
|
||||
if (latest) {
|
||||
latest = { ...latest, archivedAt: result.archivedAt };
|
||||
if (current) {
|
||||
current = { ...current, archivedAt: result.archivedAt };
|
||||
}
|
||||
return result;
|
||||
},
|
||||
@@ -495,11 +616,11 @@ function createAgentHandleFactory(daemonClient: DaemonClient): AgentHandleFactor
|
||||
daemonClient.on("agent_update", (message) => {
|
||||
const update = message.payload;
|
||||
if (update.kind === "upsert" && update.agent.id === id) {
|
||||
latest = update.agent;
|
||||
current = update.agent;
|
||||
handler(update);
|
||||
}
|
||||
if (update.kind === "remove" && update.agentId === id) {
|
||||
latest = null;
|
||||
current = null;
|
||||
handler(update);
|
||||
}
|
||||
}),
|
||||
@@ -514,32 +635,116 @@ async function openWorkspace(
|
||||
createWorkspaceHandle: WorkspaceHandleFactory,
|
||||
input: string | PaseoWorkspaceOpenOptions,
|
||||
requestId?: string,
|
||||
): Promise<PaseoWorkspaceOpenResult> {
|
||||
): Promise<PaseoWorkspaceHandle> {
|
||||
const options = typeof input === "string" ? { cwd: input, requestId } : input;
|
||||
const result = await daemonClient.openProject(options.cwd, options.requestId);
|
||||
return {
|
||||
...result,
|
||||
workspace: result.workspace ? createWorkspaceHandle(result.workspace) : null,
|
||||
};
|
||||
if (result.error || !result.workspace) {
|
||||
throw new Error(result.error ?? `The daemon did not open a workspace for ${options.cwd}`);
|
||||
}
|
||||
return createWorkspaceHandle(result.workspace);
|
||||
}
|
||||
|
||||
function resolveWorkspaceId(workspace: string | PaseoWorkspaceHandle): string {
|
||||
return typeof workspace === "string" ? workspace : workspace.id;
|
||||
}
|
||||
|
||||
function providerConfig(
|
||||
provider: PaseoAgentProvider,
|
||||
input: PaseoProviderConfigInput = {},
|
||||
): PaseoProviderConfig {
|
||||
function resolveAgentId(agent: string | PaseoAgentHandle): string {
|
||||
return typeof agent === "string" ? agent : agent.id;
|
||||
}
|
||||
|
||||
function parseProviderModel(selection: string): { provider: string; model: string } {
|
||||
const separator = selection.indexOf("/");
|
||||
if (separator <= 0 || separator === selection.length - 1) {
|
||||
throw new Error('Expected config.provider in "provider/model" format');
|
||||
}
|
||||
return {
|
||||
provider,
|
||||
...(input.model !== undefined ? { model: input.model } : {}),
|
||||
...(input.modeId !== undefined ? { modeId: input.modeId } : {}),
|
||||
...(input.thinkingOptionId !== undefined ? { thinkingOptionId: input.thinkingOptionId } : {}),
|
||||
...(input.featureValues !== undefined ? { featureValues: input.featureValues } : {}),
|
||||
provider: selection.slice(0, separator),
|
||||
model: selection.slice(separator + 1),
|
||||
};
|
||||
}
|
||||
|
||||
function waitForProvidersReady(
|
||||
daemonClient: DaemonClient,
|
||||
options: PaseoProviderWaitOptions = {},
|
||||
): Promise<PaseoProviderSnapshotResult> {
|
||||
// COMPAT(providersSnapshotCwd): added in v0.3.2, remove gate after 2027-02-10.
|
||||
if (daemonClient.getLastServerInfoMessage()?.features?.providersSnapshotCwd !== true) {
|
||||
return Promise.reject(new Error("Update the host to wait for provider discovery."));
|
||||
}
|
||||
|
||||
const { timeoutMs = 60_000, ...snapshotOptions } = options;
|
||||
|
||||
return new Promise((resolve, reject) => {
|
||||
let settled = false;
|
||||
let requestId: string | null = null;
|
||||
let snapshotCwd: string | undefined;
|
||||
const pendingUpdates = new Map<string | undefined, PaseoProviderSnapshotUpdate>();
|
||||
let latestEntries: PaseoProviderSnapshotResult["entries"] = [];
|
||||
|
||||
const cleanup = () => {
|
||||
clearTimeout(timeout);
|
||||
unsubscribe();
|
||||
};
|
||||
const finish = (snapshot: PaseoProviderSnapshotResult) => {
|
||||
if (settled) return;
|
||||
settled = true;
|
||||
cleanup();
|
||||
resolve(snapshot);
|
||||
};
|
||||
const fail = (error: unknown) => {
|
||||
if (settled) return;
|
||||
settled = true;
|
||||
cleanup();
|
||||
reject(error instanceof Error ? error : new Error(String(error)));
|
||||
};
|
||||
const updateMatches = (update: PaseoProviderSnapshotUpdate) => update.cwd === snapshotCwd;
|
||||
|
||||
const unsubscribe = daemonClient.on("providers_snapshot_update", (message) => {
|
||||
const update = message.payload;
|
||||
if (!requestId) {
|
||||
pendingUpdates.set(update.cwd, update);
|
||||
return;
|
||||
}
|
||||
if (!updateMatches(update)) return;
|
||||
latestEntries = update.entries;
|
||||
if (update.entries.some((entry) => entry.status === "loading")) return;
|
||||
finish({ ...update, requestId });
|
||||
});
|
||||
|
||||
const timeout = setTimeout(() => {
|
||||
const loading = latestEntries
|
||||
.filter((entry) => entry.status === "loading")
|
||||
.map((entry) => entry.provider)
|
||||
.join(", ");
|
||||
fail(
|
||||
new Error(
|
||||
loading
|
||||
? `Timed out waiting for providers: ${loading}`
|
||||
: "Timed out waiting for provider discovery",
|
||||
),
|
||||
);
|
||||
}, timeoutMs);
|
||||
|
||||
void daemonClient
|
||||
.getProvidersSnapshot(snapshotOptions)
|
||||
.then((snapshot) => {
|
||||
requestId = snapshot.requestId;
|
||||
snapshotCwd = snapshot.cwd;
|
||||
latestEntries = snapshot.entries;
|
||||
if (!snapshot.entries.some((entry) => entry.status === "loading")) {
|
||||
finish(snapshot);
|
||||
return;
|
||||
}
|
||||
const pendingUpdate = pendingUpdates.get(snapshotCwd);
|
||||
if (pendingUpdate && !pendingUpdate.entries.some((entry) => entry.status === "loading")) {
|
||||
finish({ ...pendingUpdate, requestId });
|
||||
}
|
||||
return undefined;
|
||||
})
|
||||
.catch(fail);
|
||||
});
|
||||
}
|
||||
|
||||
function createGeneratedClientId(): string {
|
||||
const randomId =
|
||||
typeof globalThis.crypto?.randomUUID === "function"
|
||||
|
||||
Reference in New Issue
Block a user