@fungi.computer/oyster 0.3.2 → 0.4.0

package/dist/workers.d.ts

@@ -110,23 +110,24 @@ export declare class OysterRegistry<Env extends OysterWorkerEnv = OysterWorkerEn
     }>): Promise<{
         readonly record: {
             readonly revision: number;
+            readonly expiresAt: number;
+            readonly operation: string;
+            readonly description: {
+                readonly title: string;
+                readonly inputBytes: number;
+                readonly inputSha256: string;
+            };
             readonly by: {
                 readonly kind: "human";
                 readonly memberId: string;
             } | {
                 readonly kind: "policy";
             } | null;
-            readonly description: {
-                readonly title: string;
-                readonly inputBytes: number;
-                readonly inputSha256: string;
-            };
-            readonly operation: string;
             readonly access: "write" | "external";
-            readonly expiresAt: number;
             readonly reason: "pending" | "expired" | "not-found" | "not-eligible" | "already-answered" | "stale-revision" | "declined" | "fenced" | "not-granted" | "read-only" | "in-flight" | "outcome-unknown" | "identity-conflict" | null;
             readonly updatedAt: number;
             readonly module: string;
+            readonly state: "pending" | "expired" | "denied" | "applied" | "requested" | "approved" | "claimed" | "outcome_unknown";
             readonly recordId: string;
             readonly authorityFence: string;
             readonly requester: {
@@ -136,7 +137,6 @@ export declare class OysterRegistry<Env extends OysterWorkerEnv = OysterWorkerEn
                 readonly displayName: string;
             };
             readonly reversibility: "reversible" | "irreversible-external";
-            readonly state: "pending" | "expired" | "denied" | "applied" | "requested" | "approved" | "claimed" | "outcome_unknown";
             readonly requestedAt: number;
             readonly evidence?: readonly {
                 readonly kind: "artifact";

package/docs/api/agents.md

@@ -203,6 +203,47 @@ type OysterAgents = Readonly<{
         error: "not_found" | "not_granted";
       }>
   >;
+  readModelChoice: Promise<{
+    keySource: "workers-ai" | "ai-gateway" | "byok";
+    model: {
+      providerId: Schema.String;
+      modelId: Schema.String;
+      reasoning?: Schema.optional<
+        Schema.Literals<
+          readonly ["minimal", "low", "medium", "high", "xhigh", "max"]
+        >
+      >;
+    };
+  } | null>;
+  decodeModelChoice: {
+    keySource: "workers-ai" | "ai-gateway" | "byok";
+    model: {
+      providerId: Schema.String;
+      modelId: Schema.String;
+      reasoning?: Schema.optional<
+        Schema.Literals<
+          readonly ["minimal", "low", "medium", "high", "xhigh", "max"]
+        >
+      >;
+    };
+  } | null;
+  setModelChoice: Promise<
+    | {
+        keySource: "workers-ai" | "ai-gateway" | "byok";
+        model: {
+          providerId: Schema.String;
+          modelId: Schema.String;
+          reasoning?: Schema.optional<
+            Schema.Literals<
+              readonly ["minimal", "low", "medium", "high", "xhigh", "max"]
+            >
+          >;
+        };
+      }
+    | Readonly<{
+        error: "not_found" | "not_granted" | AgentModelRefusal;
+      }>
+  >;
   policyStatus: Promise<Readonly<{
     status: "pending" | "approved";
     revision: string;
@@ -262,6 +303,31 @@ type OysterAgents = Readonly<{
 
 Where an Oyster's agents live and run.
 
+---
+
+### AgentModelChoice
+
+```ts
+type AgentModelChoice = typeof agentModelChoiceSchema.Type;
+```
+
+The Agent's model preference and source reference, never credential material.
+
+---
+
+### AgentModelRefusal
+
+```ts
+type AgentModelRefusal =
+  | "invalid_model_choice"
+  | "unsupported_key_source"
+  | "key_source_mismatch"
+  | "model_unavailable"
+  | "key_not_connected";
+```
+
+Stable reason for rejecting a model or credential source before a run.
+
 ## Variables
 
 ### maxAgentMcpServers