@opencode/protocol 2.0.2 → 2.0.4

package/dist/groups/pty.d.ts

@@ -1,4 +1,3 @@
-import { Location } from "@opencode/schema/location";
 import { Schema } from "effect";
 import { HttpApiEndpoint, HttpApiGroup, HttpApiSchema } from "effect/unstable/httpapi";
 import { ForbiddenError, PtyNotFoundError } from "../errors.js";
@@ -9,10 +8,11 @@ export declare function hasPtyConnectTicketURL(url: URL): boolean;
 export declare const PtyGroup: HttpApiGroup.HttpApiGroup<"server.pty", HttpApiEndpoint.HttpApiEndpoint<"pty.list", "GET", "/api/pty", never, Schema.toCodecStringTree<Schema.Struct<{
     readonly location: Schema.optional<Schema.Struct<{
         readonly directory: Schema.optional<Schema.String>;
-        readonly workspace: Schema.optional<Schema.String>;
     }>>;
 }>>, never, never, Schema.toCodecJson<Schema.Struct<{
-    readonly location: typeof Location.Info;
+    readonly location: Schema.Struct<{
+        readonly directory: Schema.brand<Schema.String, "AbsolutePath">;
+    }>;
     readonly data: Schema.$Array<Schema.Struct<{
         readonly id: Schema.brand<Schema.String, "PtyID"> & {
             create: () => string & import("effect/Brand").Brand<"PtyID">;
@@ -29,7 +29,6 @@ export declare const PtyGroup: HttpApiGroup.HttpApiGroup<"server.pty", HttpApiEn
 }>>, never, never, never> | HttpApiEndpoint.HttpApiEndpoint<"pty.create", "POST", "/api/pty", never, Schema.toCodecStringTree<Schema.Struct<{
     readonly location: Schema.optional<Schema.Struct<{
         readonly directory: Schema.optional<Schema.String>;
-        readonly workspace: Schema.optional<Schema.String>;
     }>>;
 }>>, Schema.toCodecJson<Schema.Struct<{
     readonly command: Schema.decodeTo<Schema.optional<Schema.toType<Schema.String>>, Schema.optionalKey<Schema.String>, never, never>;
@@ -38,7 +37,9 @@ export declare const PtyGroup: HttpApiGroup.HttpApiGroup<"server.pty", HttpApiEn
     readonly title: Schema.decodeTo<Schema.optional<Schema.toType<Schema.String>>, Schema.optionalKey<Schema.String>, never, never>;
     readonly env: Schema.decodeTo<Schema.optional<Schema.toType<Schema.$Record<Schema.String, Schema.String>>>, Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>, never, never>;
 }>>, never, Schema.toCodecJson<Schema.Struct<{
-    readonly location: typeof Location.Info;
+    readonly location: Schema.Struct<{
+        readonly directory: Schema.brand<Schema.String, "AbsolutePath">;
+    }>;
     readonly data: Schema.Struct<{
         readonly id: Schema.brand<Schema.String, "PtyID"> & {
             create: () => string & import("effect/Brand").Brand<"PtyID">;
@@ -60,10 +61,11 @@ export declare const PtyGroup: HttpApiGroup.HttpApiGroup<"server.pty", HttpApiEn
 }>>, Schema.toCodecStringTree<Schema.Struct<{
     readonly location: Schema.optional<Schema.Struct<{
         readonly directory: Schema.optional<Schema.String>;
-        readonly workspace: Schema.optional<Schema.String>;
     }>>;
 }>>, never, never, Schema.toCodecJson<Schema.Struct<{
-    readonly location: typeof Location.Info;
+    readonly location: Schema.Struct<{
+        readonly directory: Schema.brand<Schema.String, "AbsolutePath">;
+    }>;
     readonly data: Schema.Struct<{
         readonly id: Schema.brand<Schema.String, "PtyID"> & {
             create: () => string & import("effect/Brand").Brand<"PtyID">;
@@ -85,7 +87,6 @@ export declare const PtyGroup: HttpApiGroup.HttpApiGroup<"server.pty", HttpApiEn
 }>>, Schema.toCodecStringTree<Schema.Struct<{
     readonly location: Schema.optional<Schema.Struct<{
         readonly directory: Schema.optional<Schema.String>;
-        readonly workspace: Schema.optional<Schema.String>;
     }>>;
 }>>, Schema.toCodecJson<Schema.Struct<{
     readonly title: Schema.decodeTo<Schema.optional<Schema.toType<Schema.String>>, Schema.optionalKey<Schema.String>, never, never>;
@@ -97,7 +98,9 @@ export declare const PtyGroup: HttpApiGroup.HttpApiGroup<"server.pty", HttpApiEn
         readonly cols: Schema.Int;
     }>>, never, never>;
 }>>, never, Schema.toCodecJson<Schema.Struct<{
-    readonly location: typeof Location.Info;
+    readonly location: Schema.Struct<{
+        readonly directory: Schema.brand<Schema.String, "AbsolutePath">;
+    }>;
     readonly data: Schema.Struct<{
         readonly id: Schema.brand<Schema.String, "PtyID"> & {
             create: () => string & import("effect/Brand").Brand<"PtyID">;
@@ -119,7 +122,6 @@ export declare const PtyGroup: HttpApiGroup.HttpApiGroup<"server.pty", HttpApiEn
 }>>, Schema.toCodecStringTree<Schema.Struct<{
     readonly location: Schema.optional<Schema.Struct<{
         readonly directory: Schema.optional<Schema.String>;
-        readonly workspace: Schema.optional<Schema.String>;
     }>>;
 }>>, never, never, Schema.toCodecJson<HttpApiSchema.NoContent>, Schema.toCodecJson<typeof PtyNotFoundError>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"pty.connectToken", "POST", "/api/pty/:ptyID/connect-token", Schema.toCodecStringTree<Schema.Struct<{
     ptyID: Schema.brand<Schema.String, "PtyID"> & {
@@ -129,12 +131,13 @@ export declare const PtyGroup: HttpApiGroup.HttpApiGroup<"server.pty", HttpApiEn
 }>>, Schema.toCodecStringTree<Schema.Struct<{
     readonly location: Schema.optional<Schema.Struct<{
         readonly directory: Schema.optional<Schema.String>;
-        readonly workspace: Schema.optional<Schema.String>;
     }>>;
 }>>, never, Schema.toCodecStringTree<Schema.Struct<{
     readonly "x-opencode-ticket": Schema.optional<Schema.String>;
 }>>, Schema.toCodecJson<Schema.Struct<{
-    readonly location: typeof Location.Info;
+    readonly location: Schema.Struct<{
+        readonly directory: Schema.brand<Schema.String, "AbsolutePath">;
+    }>;
     readonly data: Schema.Struct<{
         readonly ticket: Schema.String;
         readonly expires_in: Schema.Int;

package/dist/groups/pty.js

@@ -21,7 +21,7 @@ export const PtyGroup = HttpApiGroup.make("server.pty")
 })
     .annotateMerge(locationQueryOpenApi)
     .annotateMerge(OpenApi.annotations({
-    identifier: "v2.pty.list",
+    identifier: "pty.list",
     summary: "List PTY sessions",
     description: "List PTY sessions for a location, including exited sessions retained until removal.",
 })))
@@ -32,7 +32,7 @@ export const PtyGroup = HttpApiGroup.make("server.pty")
 })
     .annotateMerge(locationQueryOpenApi)
     .annotateMerge(OpenApi.annotations({
-    identifier: "v2.pty.create",
+    identifier: "pty.create",
     summary: "Create PTY session",
     description: "Create a pseudo-terminal session for a location.",
 })))
@@ -44,7 +44,7 @@ export const PtyGroup = HttpApiGroup.make("server.pty")
 })
     .annotateMerge(locationQueryOpenApi)
     .annotateMerge(OpenApi.annotations({
-    identifier: "v2.pty.get",
+    identifier: "pty.get",
     summary: "Get PTY session",
     description: "Get one PTY session, including its exit code once exited.",
 })))
@@ -57,7 +57,7 @@ export const PtyGroup = HttpApiGroup.make("server.pty")
 })
     .annotateMerge(locationQueryOpenApi)
     .annotateMerge(OpenApi.annotations({
-    identifier: "v2.pty.update",
+    identifier: "pty.update",
     summary: "Update PTY session",
     description: "Update the title or viewport size of one PTY session.",
 })))
@@ -69,7 +69,7 @@ export const PtyGroup = HttpApiGroup.make("server.pty")
 })
     .annotateMerge(locationQueryOpenApi)
     .annotateMerge(OpenApi.annotations({
-    identifier: "v2.pty.remove",
+    identifier: "pty.remove",
     summary: "Remove PTY session",
     description: "Terminate and remove one PTY session.",
 })))
@@ -82,7 +82,7 @@ export const PtyGroup = HttpApiGroup.make("server.pty")
 })
     .annotateMerge(locationQueryOpenApi)
     .annotateMerge(OpenApi.annotations({
-    identifier: "v2.pty.connect.token",
+    identifier: "pty.connect.token",
     summary: "Create PTY WebSocket token",
     description: "Create a short-lived single-use ticket for opening a PTY WebSocket connection.",
 })))
@@ -94,7 +94,7 @@ HttpApiEndpoint.get("pty.connect", "/api/pty/:ptyID/connect", {
     success: Schema.Boolean,
     error: [ForbiddenError, PtyNotFoundError],
 }).annotateMerge(OpenApi.annotations({
-    identifier: "v2.pty.connect",
+    identifier: "pty.connect",
     summary: "Connect to PTY session",
     description: "Establish a WebSocket connection streaming PTY output and accepting terminal input.",
     transform: (operation) => ({
@@ -102,7 +102,7 @@ HttpApiEndpoint.get("pty.connect", "/api/pty/:ptyID/connect", {
         "x-websocket": true,
         parameters: [
             ...(operation.parameters ?? []),
-            ...["location[directory]", "location[workspace]", "cursor", PTY_CONNECT_TICKET_QUERY].map((name) => ({
+            ...["location[directory]", "cursor", PTY_CONNECT_TICKET_QUERY].map((name) => ({
                 in: "query",
                 name,
                 schema: { type: "string" },

package/dist/groups/reference.d.ts

@@ -1,29 +1,25 @@
-import { Location } from "@opencode/schema/location";
 import { Schema } from "effect";
 import { HttpApiEndpoint, HttpApiGroup } from "effect/unstable/httpapi";
 export declare const ReferenceGroup: HttpApiGroup.HttpApiGroup<"server.reference", HttpApiEndpoint.HttpApiEndpoint<"reference.list", "GET", "/api/reference", never, Schema.toCodecStringTree<Schema.Struct<{
     readonly location: Schema.optional<Schema.Struct<{
         readonly directory: Schema.optional<Schema.String>;
-        readonly workspace: Schema.optional<Schema.String>;
     }>>;
 }>>, never, never, Schema.toCodecJson<Schema.Struct<{
-    readonly location: typeof Location.Info;
+    readonly location: Schema.Struct<{
+        readonly directory: Schema.brand<Schema.String, "AbsolutePath">;
+    }>;
     readonly data: Schema.$Array<Schema.Struct<{
-        readonly name: Schema.String;
-        readonly path: Schema.brand<Schema.String, "AbsolutePath">;
-        readonly description: Schema.decodeTo<Schema.optional<Schema.toType<Schema.String>>, Schema.optionalKey<Schema.String>, never, never>;
-        readonly hidden: Schema.decodeTo<Schema.optional<Schema.toType<Schema.Boolean>>, Schema.optionalKey<Schema.Boolean>, never, never>;
         readonly source: Schema.Union<readonly [Schema.Struct<{
             readonly type: Schema.Literal<"local">;
             readonly path: Schema.brand<Schema.String, "AbsolutePath">;
-            readonly description: Schema.decodeTo<Schema.optional<Schema.toType<Schema.String>>, Schema.optionalKey<Schema.String>, never, never>;
-            readonly hidden: Schema.decodeTo<Schema.optional<Schema.toType<Schema.Boolean>>, Schema.optionalKey<Schema.Boolean>, never, never>;
         }>, Schema.Struct<{
             readonly type: Schema.Literal<"git">;
-            readonly repository: Schema.String;
             readonly branch: Schema.decodeTo<Schema.optional<Schema.toType<Schema.String>>, Schema.optionalKey<Schema.String>, never, never>;
-            readonly description: Schema.decodeTo<Schema.optional<Schema.toType<Schema.String>>, Schema.optionalKey<Schema.String>, never, never>;
-            readonly hidden: Schema.decodeTo<Schema.optional<Schema.toType<Schema.Boolean>>, Schema.optionalKey<Schema.Boolean>, never, never>;
+            readonly repository: Schema.String;
         }>]>;
+        readonly path: Schema.brand<Schema.String, "AbsolutePath">;
+        readonly description: Schema.decodeTo<Schema.optional<Schema.toType<Schema.String>>, Schema.optionalKey<Schema.String>, never, never>;
+        readonly name: Schema.String;
+        readonly hidden: Schema.decodeTo<Schema.optional<Schema.toType<Schema.Boolean>>, Schema.optionalKey<Schema.Boolean>, never, never>;
     }>>;
 }>>, never, never, never>, false>;

package/dist/groups/reference.js

@@ -1,16 +1,29 @@
 import { Location } from "@opencode/schema/location";
 import { Reference } from "@opencode/schema/reference";
-import { Schema } from "effect";
+import { Schema, Struct } from "effect";
 import { HttpApiEndpoint, HttpApiGroup, OpenApi } from "effect/unstable/httpapi";
 import { LocationQuery, locationQueryOpenApi } from "./location.js";
+const PublicLocalSource = Schema.Struct(Struct.omit(Reference.LocalSource.fields, ["description", "hidden"])).annotate({
+    identifier: "Reference.LocalSource",
+});
+const PublicGitSource = Schema.Struct(Struct.omit(Reference.GitSource.fields, ["description", "hidden"])).annotate({
+    identifier: "Reference.GitSource",
+});
+const PublicSource = Schema.Union([PublicLocalSource, PublicGitSource])
+    .pipe(Schema.toTaggedUnion("type"))
+    .annotate({ identifier: "Reference.Source" });
+const PublicInfo = Schema.Struct({
+    ...Struct.omit(Reference.Info.fields, ["source"]),
+    source: PublicSource,
+}).annotate({ identifier: "Reference.Info" });
 export const ReferenceGroup = HttpApiGroup.make("server.reference")
     .add(HttpApiEndpoint.get("reference.list", "/api/reference", {
     query: LocationQuery,
-    success: Location.response(Schema.Array(Reference.Info)),
+    success: Location.response(Schema.Array(PublicInfo)),
 })
     .annotateMerge(locationQueryOpenApi)
     .annotateMerge(OpenApi.annotations({
-    identifier: "v2.reference.list",
+    identifier: "reference.list",
     summary: "List references",
     description: "List references available in the requested location.",
 })))

package/dist/groups/rpc.d.ts

@@ -13,7 +13,6 @@ export declare const RpcGroup: HttpApiGroup.HttpApiGroup<"server.rpc", HttpApiEn
 }>>, Schema.toCodecStringTree<Schema.Struct<{
     readonly location: Schema.optional<Schema.Struct<{
         readonly directory: Schema.optional<Schema.String>;
-        readonly workspace: Schema.optional<Schema.String>;
     }>>;
 }>>, Schema.toCodecJson<Schema.Struct<{
     readonly input: Schema.decodeTo<Schema.optional<Schema.toType<Schema.Unknown>>, Schema.optionalKey<Schema.Unknown>, never, never>;

package/dist/groups/rpc.js

@@ -17,7 +17,7 @@ export const RpcGroup = HttpApiGroup.make("server.rpc")
 })
     .annotateMerge(locationQueryOpenApi)
     .annotateMerge(OpenApi.annotations({
-    identifier: "v2.rpc.call",
+    identifier: "rpc.call",
     summary: "Call a plugin RPC",
     description: "Dispatch a method to the currently registered RPC at the requested location.",
 })))

package/dist/groups/server.d.ts

@@ -1,5 +1,13 @@
 import { Schema } from "effect";
 import { HttpApiEndpoint, HttpApiGroup } from "effect/unstable/httpapi";
-export declare const ServerGroup: HttpApiGroup.HttpApiGroup<"server.server", HttpApiEndpoint.HttpApiEndpoint<"server.get", "GET", "/api/server", never, never, never, never, Schema.toCodecJson<Schema.Struct<{
+export declare const ServerStatus: Schema.Struct<{
+    readonly version: Schema.String;
+    readonly pid: Schema.Int;
+    readonly urls: Schema.$Array<Schema.String>;
+}>;
+export type ServerStatus = typeof ServerStatus.Type;
+export declare const ServerGroup: HttpApiGroup.HttpApiGroup<"server.server", HttpApiEndpoint.HttpApiEndpoint<"server.status", "GET", "/api/status", never, never, never, never, Schema.toCodecJson<Schema.Struct<{
+    readonly version: Schema.String;
+    readonly pid: Schema.Int;
     readonly urls: Schema.$Array<Schema.String>;
 }>>, never, never, never>, false>;

package/dist/groups/server.js

@@ -1,11 +1,17 @@
 import { Schema } from "effect";
 import { HttpApiEndpoint, HttpApiGroup, OpenApi } from "effect/unstable/httpapi";
+export const ServerStatus = Schema.Struct({
+    version: Schema.String,
+    // 0 means the runtime has no OS process identity (e.g. workerd).
+    pid: Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)),
+    urls: Schema.Array(Schema.String),
+}).annotate({ identifier: "ServerStatus" });
 export const ServerGroup = HttpApiGroup.make("server.server")
-    .add(HttpApiEndpoint.get("server.get", "/api/server", {
-    success: Schema.Struct({ urls: Schema.Array(Schema.String) }),
+    .add(HttpApiEndpoint.get("server.status", "/api/status", {
+    success: ServerStatus,
 }).annotateMerge(OpenApi.annotations({
-    identifier: "v2.server.get",
-    summary: "Get server information",
-    description: "Return the URLs that can be used to connect to this server.",
+    identifier: "server.status",
+    summary: "Get server status",
+    description: "Return the server identity, connection URLs, and readiness status.",
 })))
     .annotateMerge(OpenApi.annotations({ title: "server" }));