acp

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104// ACP provider state shared by the agent and plugin wiring. Wire payloads
// are decoded in wire.ts; these types describe state owned by Convergence.

import type * as Effect from "effect/Effect";
import type * as Fiber from "effect/Fiber";
import type * as Queue from "effect/Queue";
import type { PluginServices } from "convergence/effect";
import type { AgentEvent, SlashCommand, ToolSpec, TranscriptItem } from "convergence/protocol";
import type { Icons } from "./registry.ts";
export type { Entry, Launch } from "./registry.ts";

export interface Capabilities {
  loadSession?: boolean;
  promptCapabilities?: { image?: boolean; audio?: boolean; embeddedContext?: boolean };
  mcpCapabilities?: { http?: boolean };
  sessionCapabilities?: {
    list?: unknown;
    fork?: unknown;
    resume?: unknown;
    close?: unknown;
    additionalDirectories?: unknown;
  };
}

export interface AcpAuthMethod {
  id: string;
  name?: string | null;
  description?: string | null;
  type?: string | null;
  args?: unknown[] | null;
}

export interface AcpAgentInfo {
  name?: string | null;
  title?: string | null;
  version?: string | null;
}

export interface ModeState extends Record<string, unknown> {
  currentModeId?: string | null;
  availableModes?: Record<string, unknown>[] | null;
}

export interface ModelState extends Record<string, unknown> {
  currentModelId?: string | null;
  availableModels?: Array<
    Record<string, unknown> & { modelId?: string | null; _meta?: Record<string, unknown> | null }
  > | null;
}

export interface AcpContext {
  which(program: string): Effect.Effect<string | null, unknown, PluginServices>;
  platform(): Effect.Effect<string, unknown, PluginServices>;
  loginEnv(): Effect.Effect<Record<string, string>, never, PluginServices>;
  icons: Icons;
}

export interface SessionState {
  live: string;
  workspace: string;
  run: string | null;
  promptId: string | null;
  delivery?: import("convergence/protocol").PromptDelivery;
  modes: ModeState | null;
  models: ModelState | null;
  config: Record<string, unknown>[];
  commands: SlashCommand[];
  messageItem: string | null;
  thoughtItem: string | null;
  context: Record<string, unknown> | null;
  generation: number;
  prompting: Fiber.Fiber<void, never> | null;
  cancelling: boolean;
  tools: ToolSpec[];
  instructions: string | null;
  instructionsSent: boolean;
  mcpUrl: string | null;
}

export interface Pending<A> {
  session: string | null;
  resolve(value: A): void;
}

export interface QuestionAnswer {
  values?: Record<string, unknown>;
  cancelled?: boolean;
}

export interface SessionHolder {
  tools?: SessionState["tools"];
  instructions?: string | null;
  mcpUrl: string | null;
}

export interface AcpDefaults {
  modes: ModeState | null;
  models: ModelState | null;
  configOptions: null;
}

export type Jobs = Queue.Queue<Effect.Effect<unknown, unknown, PluginServices>>;
export type Event = AgentEvent;
export type History = TranscriptItem[];