@ycodium-ai/plugin-api 0.2.2998 → 0.2.3002

package/dist/pluginContextThreads.d.ts

@@ -0,0 +1,206 @@
+/**
+ * 插件 ctx 的会话面：线程活动、附件、消息、轮次意图和线程只读视图。
+ * 公开名字从包入口再导出。
+ *
+ * @module @ycodium-ai/plugin-api/pluginContextThreads
+ */
+import type { PluginModelSelection } from "./pluginContextProviders.ts";
+/** 投影出来的一条线程活动。payload 保持 unknown，由插件按 kind 收窄。 */
+export interface PluginActivity {
+    readonly activityId: string;
+    readonly threadId: string;
+    readonly turnId: string | null;
+    readonly kind: string;
+    readonly tone?: string | undefined;
+    readonly summary: string;
+    readonly payload: unknown;
+    readonly createdAt: string;
+}
+/** thread 里的一条消息。附件、逐条模型选择这类界面用的字段不透出。 */
+/**
+ * 一份要落成会话附件的字节。
+ *
+ * 大小上限沿用宿主对聊天附件的那一份（按 mime 分档，图片与文件不同），超了就 reject
+ * —— 插件不该有一条比人从网页上传更宽的路。
+ */
+export interface PluginAttachmentInput {
+    /** 附件挂在哪条会话下。落盘目录按它分，删会话时一起回收。 */
+    readonly threadId: string;
+    readonly name: string;
+    readonly mimeType: string;
+    readonly bytes: Uint8Array;
+}
+/** 落好盘的附件。原样塞进 `thread.turn.start` 的 `message.attachments` 即可。 */
+export interface PluginAttachment {
+    /** mime 是 `image/*` 就是 `image`，其余都是 `file`。 */
+    readonly type: "image" | "file";
+    readonly id: string;
+    readonly name: string;
+    readonly mimeType: string;
+    readonly sizeBytes: number;
+}
+/**
+ * 把字节落成会话附件。插件面上唯一的字节写口。
+ *
+ * 为什么需要它：`ctx.commands.dispatch` 收的是**已经规范化**的命令，附件那一格只认
+ * 落好盘的记录（`{id, name, mimeType, sizeBytes}`），不认 data URL —— 网页客户端那条
+ * 路由宿主的规范化器代劳，插件得自己先落一次。
+ */
+export interface PluginAttachments {
+    readonly store: (input: PluginAttachmentInput) => Promise<PluginAttachment>;
+    /**
+     * 按 id 读回字节。附件不在这台机器上就 reject，不回空字节 —— 「没有」与「是空的」
+     * 是两回事。
+     *
+     * 不需要声明：这些 id 本来就写在 `getThread` / `getThreadMessage` 读得到的消息上，
+     * 这条只是把「看得见记录」补成「读得到内容」。
+     */
+    readonly read: (attachmentId: string) => Promise<Uint8Array>;
+}
+export interface PluginThreadMessage {
+    readonly messageId: string;
+    readonly role: string;
+    readonly text: string;
+    readonly turnId: string | null;
+    readonly createdAt: string;
+    readonly modelSelection?: PluginModelSelection | undefined;
+    readonly source?: {
+        readonly kind: "native-session";
+        readonly provider: "claude" | "codex";
+        readonly sessionId: string;
+        readonly messageId: string;
+        readonly turnId?: string | undefined;
+        readonly order: number;
+    } | undefined;
+    /** 这条消息带的附件；要字节走 `ctx.attachments.read(id)`。 */
+    readonly attachments: readonly PluginAttachment[];
+}
+/** thread 当前的 provider 会话状态。没建过会话是 null。 */
+export interface PluginThreadSession {
+    /** `idle` / `starting` / `running` / `stopped`…… 宿主的会话状态名。 */
+    readonly status: string;
+    readonly providerInstanceId: string | null;
+    /** 正在跑的 turn；空闲是 null。 */
+    readonly activeTurnId: string | null;
+    readonly lastError?: string | null | undefined;
+    readonly updatedAt?: string | undefined;
+    readonly endReason?: "server-restart" | undefined;
+}
+export interface PluginThreadOrigin {
+    readonly parentThreadId: string;
+    readonly delegationDepth: number;
+    readonly requestedBy: "agent" | "continuation";
+    readonly notificationPolicy?: "wake" | "activity-only" | undefined;
+}
+export interface PluginThreadForkPoint {
+    readonly sourceThreadId: string;
+    readonly sourceMessageId: string;
+}
+export interface PluginTurnIntent {
+    readonly intentId: string;
+    readonly threadId: string;
+    readonly sequence: number;
+    readonly commandId: string;
+    readonly messageId: string;
+    readonly revision: number;
+    readonly turn: {
+        readonly turnId: string | null;
+        readonly userMessageId: string;
+        readonly state: "pending" | "running" | "interrupted" | "completed" | "error";
+        readonly requestedAt: string;
+        readonly startedAt: string | null;
+        readonly completedAt: string | null;
+        readonly waitSpans: readonly {
+            readonly kind: "approval" | "userInput";
+            readonly requestId: string;
+            readonly startedAt: string;
+            readonly completedAt: string | null;
+        }[];
+    } | null;
+    readonly status: "queued" | "preparing" | "dispatching" | "running" | "completed" | "interrupted" | "failed" | "reconciling" | "blocked" | "cancelled" | "abandoned";
+    readonly deliveryCertainty: "not-dispatched" | "confirmed" | "unknown";
+    readonly attempt: {
+        readonly attemptId: string;
+        readonly workerEpoch: number;
+        readonly sourceBindingId: string | null;
+        readonly targetBindingId: string | null;
+        readonly stage: "preparing" | "dispatching" | "running" | "reconciling";
+        readonly deliveryCertainty: "not-dispatched" | "confirmed" | "unknown";
+        readonly nativeLocator: {
+            readonly sessionId?: string | undefined;
+            readonly turnId?: string | undefined;
+            readonly generationId?: string | undefined;
+        } | null;
+        readonly createdAt: string;
+        readonly updatedAt: string;
+    } | null;
+    readonly blockedReason: string | null;
+    readonly replacementIntentId: string | null;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+}
+/** 不加载消息历史；持久状态在同一数据库快照内读取，进程存活另取当前 provider 句柄。 */
+export interface PluginThreadExecution {
+    readonly threadId: string;
+    readonly projectId: string;
+    readonly title: string;
+    readonly modelSelection: PluginModelSelection;
+    readonly runtimeMode: "approval-required" | "auto-accept-edits" | "auto" | "full-access";
+    readonly interactionMode: "default" | "plan";
+    readonly branch: string | null;
+    readonly worktreePath: string | null;
+    readonly origin: PluginThreadOrigin | null;
+    readonly forkedFrom: PluginThreadForkPoint | null;
+    readonly archivedAt: string | null;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly session: (PluginThreadSession & {
+        readonly lastError: string | null;
+        readonly updatedAt: string;
+    }) | null;
+    readonly latestTurn: {
+        readonly turnId: string;
+        readonly state: "running" | "interrupted" | "completed" | "error";
+        readonly requestedAt: string;
+        readonly startedAt: string | null;
+        readonly completedAt: string | null;
+        readonly userMessageId?: string | undefined;
+        readonly assistantMessageId: string | null;
+        readonly waitSpans?: readonly {
+            readonly kind: "approval" | "userInput";
+            readonly requestId: string;
+            readonly startedAt: string;
+            readonly completedAt: string | null;
+        }[] | undefined;
+    } | null;
+    readonly turnIntents: readonly PluginTurnIntent[];
+    readonly queuePaused: boolean;
+    readonly providerProcessLive: boolean;
+    readonly hasPendingApprovals: boolean;
+    readonly hasPendingUserInput: boolean;
+    readonly pendingApprovalCount: number;
+    readonly pendingUserInputCount: number;
+    /** 持久 turn-start-requested 事实总数，含普通客户端入口；与导入用户消息数不同。 */
+    readonly turnStartCount: number;
+}
+/**
+ * 一条 thread 的只读视图：消息列表加会话状态。
+ *
+ * 默认不带活动、checkpoint、提案计划；原生历史对齐可显式请求有界活动窗口。
+ */
+export interface PluginThread {
+    readonly threadId: string;
+    readonly projectId: string;
+    readonly title: string;
+    readonly modelSelection: PluginModelSelection;
+    readonly origin?: PluginThreadOrigin | null | undefined;
+    readonly forkedFrom?: PluginThreadForkPoint | null | undefined;
+    /** 归档过的 thread 有值；活着的是 null。 */
+    readonly archivedAt: string | null;
+    readonly messages: readonly PluginThreadMessage[];
+    /** 仅显式请求时带回当前有界窗口的活动，供原生历史对齐；不含检查点或提案。 */
+    readonly activities?: readonly PluginActivity[] | undefined;
+    readonly session: PluginThreadSession | null;
+    readonly updatedAt: string;
+}
+//# sourceMappingURL=pluginContextThreads.d.ts.map

package/dist/pluginContextThreads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginContextThreads.d.ts","sourceRoot":"","sources":["../src/pluginContextThreads.ts"],"names":[],"mappings":"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"}

package/dist/pluginContextThreads.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pluginContextThreads.js.map

package/dist/pluginContextThreads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginContextThreads.js","sourceRoot":"","sources":["../src/pluginContextThreads.ts"],"names":[],"mappings":""}

package/dist/pluginContextWorkspace.d.ts

@@ -0,0 +1,76 @@
+/**
+ * 插件 ctx 的工作区面：项目 setup、代理选择和项目只读视图。
+ * 公开名字从包入口再导出。
+ *
+ * @module @ycodium-ai/plugin-api/pluginContextWorkspace
+ */
+import type { ProjectsGetOutput } from "./dataPorts.gen.ts";
+export interface PluginWorkspace {
+    /** 为本插件创建的独立工作树会话运行项目已配置的 setup 脚本，沿用宿主终端。 */
+    readonly setupThread: (threadId: string) => Promise<{
+        readonly status: "no-script";
+    } | {
+        readonly status: "started";
+        readonly scriptId: string;
+        readonly scriptName: string;
+        readonly terminalId: string;
+        readonly cwd: string;
+    }>;
+}
+/**
+ * 这台机器上配着的一个代理。**不含密码**：宿主自己往连接上加 `Proxy-Authorization`，
+ * 插件不需要、也拿不到那份凭据。
+ */
+export interface PluginProxy {
+    readonly id: string;
+    readonly displayName?: string | undefined;
+    readonly protocol: "http" | "https";
+    readonly host: string;
+    readonly port: number;
+    /** 不经这个代理直连的地址，逗号分隔。本机地址是硬约束，不在这里出现。 */
+    readonly bypass?: string | undefined;
+    /** 这一个就是机器的全局默认。整张表都没有 true 时，默认即直连。 */
+    readonly isDefault: boolean;
+}
+/**
+ * 选哪个代理。与设置里每条功能的代理选择同义：
+ *
+ * - **省略 / `undefined`** —— 跟这台机器的全局默认走。
+ * - **`null`** —— 不加 Ycodium 配的代理。注意它只停 Ycodium 这一份：机器环境里的
+ *   `HTTP_PROXY` / `HTTPS_PROXY` 照旧生效，宿主不去剥它们。
+ * - **代理 id** —— 用那一个。指向一个不存在的 id **静默退化成直连**。
+ * - **`{ required: id }`** —— 必须用那一个。代理不存在、设置读不出来、连不上
+ *   都 **reject**，不改走直连。订阅凭据这种不能从本机打出去的请求用这一档。
+ *
+ * 三态里悬空 id 仍静默直连，与 `ctx.http` 同一条规则：手改配置文件不该把长连接搞挂。
+ * 要确认某个 id 现在还在，先 `list()`。
+ */
+export type PluginRequiredProxySelection = {
+    readonly required: string;
+};
+export type PluginProxySelection = string | null | PluginRequiredProxySelection;
+/**
+ * 按代理出网。列出这台机器配了什么，然后挑一个出网 —— IM 桥那种「每个实例各配
+ * 各的代理」的功能靠它，不必给每个实例塞一份自己的 HTTP 客户端。
+ */
+export interface PluginProxies {
+    /** 这台机器配着的代理，按 id 升序。一个都没配就是空数组，不是错误。 */
+    readonly list: () => Promise<readonly PluginProxy[]>;
+    /**
+     * 按三态选择出网的 fetch。选择在**调用时**解析（跟着当前设置走），拿到的 fetch
+     * 之后一直走那个代理 —— 所以设置改了要重新调一次，别把返回值缓存一辈子。
+     *
+     * `ctx.http` 等价于建插件时调过一次 `fetch()`（省略参数那一档）：一样的解析规则、
+     * 一样的连接池，只是解析发生在宿主建能力面的时刻。想让改过的代理设置立刻生效而
+     * 不重启，就用这条重新要一个。
+     */
+    readonly fetch: (proxy?: PluginProxySelection | undefined) => Promise<typeof globalThis.fetch>;
+}
+/**
+ * 一个 project：`ctx.projects.get` 的结果、`ctx.projects.list` 的一行，形状由公共契约生成。项目号是 `id`；
+ * 仓库身份在 `repositoryIdentity`（工作区不是 git 仓库、没有可用 remote、或远端地址认不准时是 null），
+ * 其中 `canonicalKey` 是跨机器可比的 `host/owner/repo`，`provider` 认不出托管方时缺席，远端在 `locator` 里
+ * （地址已去掉凭据，只供显示与取主机名）。`archivedAt` 缺席或 null 都表示未归档。
+ */
+export type PluginProject = ProjectsGetOutput;
+//# sourceMappingURL=pluginContextWorkspace.d.ts.map

package/dist/pluginContextWorkspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginContextWorkspace.d.ts","sourceRoot":"","sources":["../src/pluginContextWorkspace.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAC/C;QAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;KAAE,GAChC;QACE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;QAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;KACtB,CACJ,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,wCAAwC;IACxC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,4BAA4B,GAAG;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AACzE,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,IAAI,GAAG,4BAA4B,CAAC;AAEhF;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAAC;IACrD;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,oBAAoB,GAAG,SAAS,KAAK,OAAO,CAAC,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;CAChG;AAED;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,iBAAiB,CAAC"}

package/dist/pluginContextWorkspace.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pluginContextWorkspace.js.map

package/dist/pluginContextWorkspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginContextWorkspace.js","sourceRoot":"","sources":["../src/pluginContextWorkspace.ts"],"names":[],"mappings":""}

package/dist/projects.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 按号取项目的一处公共实现：`ctx.projects.get` 对「没有这个项目」是拒绝，这里还原成 null。
+ *
+ * @module @ycodium-ai/plugin-api/projects
+ */
+import type { PluginDataPorts, ProjectsGetOutput } from "./dataPorts.gen.ts";
+/**
+ * 按号取项目：号为空白、项目不存在或已删都是 null；归档的照常给。
+ *
+ * 约束：宿主对「没有这个项目」的拒绝值带 `_tag: "ProjectNotFoundError"`；对空白号拒的是输入校验，
+ * 没有这个标记，所以空白号在调用宿主之前先拦下。别的失败（读模型没装配、存储出错）原样抛出，
+ * 不当成「没有」。
+ */
+export declare function projectOrNull(projects: Pick<PluginDataPorts["projects"], "get">, projectId: string): Promise<ProjectsGetOutput | null>;
+//# sourceMappingURL=projects.d.ts.map

package/dist/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../src/projects.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE7E;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,EAClD,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAQnC"}

package/dist/projects.js

@@ -0,0 +1,23 @@
+/**
+ * 按号取项目：号为空白、项目不存在或已删都是 null；归档的照常给。
+ *
+ * 约束：宿主对「没有这个项目」的拒绝值带 `_tag: "ProjectNotFoundError"`；对空白号拒的是输入校验，
+ * 没有这个标记，所以空白号在调用宿主之前先拦下。别的失败（读模型没装配、存储出错）原样抛出，
+ * 不当成「没有」。
+ */
+export async function projectOrNull(projects, projectId) {
+    if (projectId.trim() === "")
+        return null;
+    try {
+        return await projects.get({ projectId });
+    }
+    catch (error) {
+        if (isProjectNotFound(error))
+            return null;
+        throw error;
+    }
+}
+const isProjectNotFound = (error) => typeof error === "object" &&
+    error !== null &&
+    error._tag === "ProjectNotFoundError";
+//# sourceMappingURL=projects.js.map

package/dist/projects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.js","sourceRoot":"","sources":["../src/projects.ts"],"names":[],"mappings":"AAOA;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAkD,EAClD,SAAiB;IAEjB,IAAI,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IACzC,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,iBAAiB,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAC1C,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,iBAAiB,GAAG,CAAC,KAAc,EAAW,EAAE,CACpD,OAAO,KAAK,KAAK,QAAQ;IACzB,KAAK,KAAK,IAAI;IACb,KAAqC,CAAC,IAAI,KAAK,sBAAsB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ycodium-ai/plugin-api",
-  "version": "0.2.2998",
+  "version": "0.2.3002",
   "description": "Types and definePlugin for authoring Ycodium plugins. Zero runtime dependencies.",
   "keywords": [
     "ycodium"