@opencode/plugin 0.0.0-dev-20927 → 0.0.0-dev-20929

package/dist/effect/permission.d.ts

@@ -2,6 +2,9 @@ import type { PermissionApi } from "@opencode/client/effect/api";
 import type { Agent } from "@opencode/schema/agent";
 import type { Permission } from "@opencode/schema/permission";
 import type { Session } from "@opencode/schema/session";
+import type { Tool } from "@opencode/schema/tool";
+import type { Effect } from "effect";
+import type { AssertInput } from "../permission.js";
 import type { Hooks } from "./registration.js";
 export interface PermissionEvaluation {
     readonly sessionID: Session.ID;
@@ -18,4 +21,10 @@ export interface PermissionHooks {
 }
 export type PermissionDomain = Pick<PermissionApi<unknown>, "list" | "get" | "reply"> & {
     readonly hook: Hooks<PermissionHooks>;
+    /**
+     * Evaluates the session's permission rules and, when approval is required, prompts the user and
+     * waits for the reply. Succeeds when allowed. A deny rule or a rejection with feedback fails with a
+     * `Tool.Error` carrying the reason; a plain rejection ends the current step.
+     */
+    readonly assert: (input: AssertInput) => Effect.Effect<void, Tool.Error>;
 };

package/dist/permission.d.ts

@@ -0,0 +1,23 @@
+import { Schema } from "effect";
+export declare const AssertInput: Schema.Struct<{
+    readonly sessionID: Schema.brand<Schema.String, "SessionID"> & {
+        create: () => string & import("effect/Brand").Brand<"SessionID">;
+        descending: (id?: string) => string & import("effect/Brand").Brand<"SessionID">;
+    };
+    readonly agent: Schema.optional<Schema.brand<Schema.String, "Agent.ID">>;
+    readonly action: Schema.String;
+    readonly resources: Schema.$Array<Schema.String>;
+    readonly save: Schema.decodeTo<Schema.optional<Schema.toType<Schema.$Array<Schema.String>>>, Schema.optionalKey<Schema.$Array<Schema.String>>, never, never>;
+    readonly metadata: Schema.decodeTo<Schema.optional<Schema.toType<Schema.$Record<Schema.String, Schema.Unknown>>>, Schema.optionalKey<Schema.$Record<Schema.String, Schema.Unknown>>, never, never>;
+    readonly source: Schema.decodeTo<Schema.optional<Schema.toType<Schema.Union<readonly [Schema.Struct<{
+        readonly type: Schema.Literal<"tool">;
+        readonly messageID: Schema.String;
+        readonly id: Schema.String;
+    }>]>>>, Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+        readonly type: Schema.Literal<"tool">;
+        readonly messageID: Schema.String;
+        readonly id: Schema.String;
+    }>]>>, never, never>;
+}>;
+export interface AssertInput extends Schema.Schema.Type<typeof AssertInput> {
+}

package/dist/permission.js

@@ -0,0 +1,12 @@
+import { Agent } from "@opencode/schema/agent";
+import { Permission } from "@opencode/schema/permission";
+import { Schema } from "effect";
+export const AssertInput = Schema.Struct({
+    sessionID: Permission.Request.fields.sessionID,
+    agent: Agent.ID.pipe(Schema.optional),
+    action: Permission.Request.fields.action,
+    resources: Permission.Request.fields.resources,
+    save: Permission.Request.fields.save,
+    metadata: Permission.Request.fields.metadata,
+    source: Permission.Request.fields.source,
+});

package/dist/promise/adapter.js

@@ -2,6 +2,7 @@ import { Tool } from "@opencode/schema/tool";
 import { Effect, Schema, SchemaAST, Stream } from "effect";
 import { HttpApiEndpoint, HttpApiSchema } from "effect/http-api";
 import { define } from "../effect/plugin.js";
+import { AssertInput } from "../permission.js";
 const compiledEndpoints = new WeakMap();
 const JsonInput = Schema.fromJsonString(Schema.Unknown);
 class ReturnedRpcError extends Error {
@@ -312,6 +313,7 @@ export function fromPromise(plugin) {
                     list: adaptApiMethod(PermissionEndpoints["session.permission.list"], host.permission.list),
                     get: adaptApiMethod(PermissionEndpoints["session.permission.get"], host.permission.get),
                     reply: adaptApiMethod(PermissionEndpoints["session.permission.reply"], host.permission.reply),
+                    assert: (input) => run(Schema.decodeUnknownEffect(AssertInput)(input).pipe(Effect.flatMap(host.permission.assert))),
                 },
                 plugin: {
                     list: adaptApiMethod(PluginEndpoints["plugin.list"], host.plugin.list),

package/dist/promise/permission.d.ts

@@ -2,6 +2,7 @@ import type { PermissionApi } from "@opencode/client/promise/api";
 import type { Agent } from "@opencode/schema/agent";
 import type { Permission } from "@opencode/schema/permission";
 import type { Session } from "@opencode/schema/session";
+import type { AssertInput } from "../permission.js";
 import type { Hooks } from "./registration.js";
 export interface PermissionEvaluation {
     readonly sessionID: Session.ID;
@@ -18,4 +19,11 @@ export interface PermissionHooks {
 }
 export type PermissionDomain = Pick<PermissionApi, "list" | "get" | "reply"> & {
     readonly hook: Hooks<PermissionHooks>;
+    /**
+     * Evaluates the session's permission rules and, when approval is required, prompts the user and
+     * waits for the reply. Resolves when allowed. A deny rule or a rejection with feedback rejects with
+     * a `Tool.Error` carrying the reason. A plain rejection rejects with an error that ends the current
+     * step; rethrow it rather than returning it as tool output.
+     */
+    readonly assert: (input: typeof AssertInput.Encoded) => Promise<void>;
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@opencode/plugin",
-  "version": "0.0.0-dev-20927",
+  "version": "0.0.0-dev-20929",
   "type": "module",
   "license": "MIT",
   "scripts": {
@@ -47,15 +47,15 @@
   ],
   "dependencies": {
     "@ai-sdk/provider": "3.0.8",
-    "@opencode/ai": "0.0.0-dev-20927",
-    "@opencode/client": "0.0.0-dev-20927",
-    "@opencode/protocol": "0.0.0-dev-20927",
-    "@opencode/schema": "0.0.0-dev-20927",
-    "@opencode/util": "0.0.0-dev-20927",
+    "@opencode/ai": "0.0.0-dev-20929",
+    "@opencode/client": "0.0.0-dev-20929",
+    "@opencode/protocol": "0.0.0-dev-20929",
+    "@opencode/schema": "0.0.0-dev-20929",
+    "@opencode/util": "0.0.0-dev-20929",
     "effect": "4.0.1"
   },
   "peerDependencies": {
-    "@opencode/theme": "0.0.0-dev-20927",
+    "@opencode/theme": "0.0.0-dev-20929",
     "@opentui/core": ">=0.6.3",
     "@opentui/solid": ">=0.6.3",
     "solid-js": ">=1.9.0"
@@ -75,7 +75,7 @@
     }
   },
   "devDependencies": {
-    "@opencode/theme": "0.0.0-dev-20927",
+    "@opencode/theme": "0.0.0-dev-20929",
     "@opentui/core": "0.6.3",
     "@opentui/solid": "0.6.3",
     "@tsconfig/bun": "1.0.9",