@fungi.computer/oyster 0.6.0 → 0.8.0

package/dist/standalone/agents.d.ts

@@ -1,7 +1,5 @@
 import { type StandaloneTenancyEnv } from "./tenancy.js";
 import type { PostEnvelope } from "@fungi.computer/carrier/post";
-import { type ChannelConversations } from "../channels/conversations.js";
-import type { ConversationBinding } from "../channels/binding.js";
 import { type StandaloneMachineLinkBindings, type StandaloneMachineJoinResult } from "./machine-link.js";
 import { type MachineAgentSettlementPrincipal, type MachineAgentHome, type MachineEnrollment, type MachineLinkCaller, type MachineLinkIdentity } from "../machine-link/index.js";
 /** Workers AI binding surface used by the standalone provider adapter. */
@@ -21,13 +19,14 @@ import type { CloudflareShiitakeOptions } from "@fungi.computer/shiitake/cloudfl
 import { type AgentModelChoice, type AgentModelRefusal } from "./agent-model-choice.js";
 import * as Schema from "effect/Schema";
 import { type FrameBindingProps } from "../cloudflare.js";
+import { type AppAgentScheduleListInput, type AgentSchedulePage, type AgentScheduleTarget, type AgentScheduleControlReceipt } from "../agent-schedules.js";
 import type { Avatar } from "@fungi.computer/sprite/avatar";
 import type { InvocationFrame } from "../invocation.js";
 import type { OysterJson } from "../host.js";
 import { type FleetMessage } from "@fungi.computer/shiitake/fleet";
 import { type AppToolPolicy } from "../apps/index.js";
-import { type OysterPrincipal, type OysterHost } from "../host.js";
-import { type TenantScope, type TenantId } from "../tenant.js";
+import { type OysterHost } from "../host.js";
+import { type TenantScope, type TenantId, type TenantPrincipal } from "../tenant.js";
 import type { ReadonlyTenancy } from "../tenancy/index.js";
 import type { HostActor } from "@fungi.computer/puffball/app";
 import type { OysterWorkerEnv } from "../workers.js";
@@ -78,14 +77,12 @@ export type AgentInboxRows = Readonly<{
 /** One agent: Shiitake's Cloudflare host over this Durable Object; its root supplies `hostFor`. */
 export declare abstract class StandaloneAgentBase<Env extends StandaloneAgentEnv = StandaloneAgentEnv> extends ShiitakeDO<Env> {
     #private;
+    private archiveControlOwner;
+    private archiveControl;
+    /** Owner-local atomic transition. The caller checks human/creator authority. */
+    setArchived(archived: boolean): Promise<import("./agent-archive-owner.js").AgentArchiveTransitionResult>;
     /** The deployable root's host for this Agent's pinned tenant. */
     protected abstract hostFor(scope: TenantScope): Promise<OysterHost>;
-    /**
-     * Compose Oyster's channel owner on this Agent's real store and Shiitake.
-     * A host must supply its own binding lookup after authenticating its edge;
-     * this does not install an inbound route or mint provider credentials.
-     */
-    protected channelConversations(binding: (bindingId: string) => ConversationBinding | null): ChannelConversations;
     private uiOwner;
     private machineClient;
     private computerSnapshot;
@@ -133,6 +130,12 @@ export declare abstract class StandaloneAgentBase<Env extends StandaloneAgentEnv
     }): Promise<void>;
     /** Host-only policy pin read, used before an owner can approve tools. */
     policyDirectory(): Promise<typeof policyDirectorySchema.Type | null>;
+    /** Borrow the native owner only after matching its real initialization pin. */
+    private scheduleOwner;
+    /** One admitted Agent's bounded native schedule page; this is not a directory scan. */
+    readSchedules(directory: typeof policyDirectorySchema.Type, input: AppAgentScheduleListInput): Promise<AgentSchedulePage>;
+    /** Manage authority returns native identity/state only, never schedule content. */
+    controlSchedule(directory: typeof policyDirectorySchema.Type, input: AgentScheduleTarget, action: "pause" | "resume" | "delete"): Promise<AgentScheduleControlReceipt>;
     /** Listeners from live codemode acquisitions, told when the server list changes. */
     private readonly mcpInvalidations;
     private storedMcpServers;
@@ -157,6 +160,12 @@ export declare abstract class StandaloneAgentBase<Env extends StandaloneAgentEnv
 }
 /** Names this Oyster's agents and remembers which Sessions the member opened. */
 export declare class AgentDirectory extends DurableObject<StandaloneAgentEnv> {
+    private archiveProjectionOwner;
+    private archiveProjection;
+    /** Apply the Agent DO's revisioned fact; an older repair cannot undo a newer one. */
+    recordArchive(agentId: string, archived: boolean, revision: number): boolean;
+    /** Directory's bounded-stale projection, never the Agent's flag authority. */
+    archived(agentId: string): boolean;
     private readonly computers;
     private readonly computerNames;
     private readonly directory;
@@ -209,26 +218,30 @@ export declare class AgentDirectory extends DurableObject<StandaloneAgentEnv> {
     agentComputerSnapshot(agentId: string, tenantId?: TenantId): Promise<AgentComputerSnapshot | null>;
     private computerCommand;
     /** Owner attachment commands retain the shared owner's receipts and versions. */
-    attachComputer(command: ComputerAttachmentInput, principal: OysterPrincipal, tenantId?: TenantId): Promise<StandaloneAgentComputerReply>;
+    attachComputer(command: ComputerAttachmentInput, principal: TenantPrincipal, tenantId?: TenantId): Promise<StandaloneAgentComputerReply>;
     /** Detach advances the owner version and invalidates the Agent's held discovery. */
-    detachComputer(command: ComputerAttachmentInput, principal: OysterPrincipal, tenantId?: TenantId): Promise<StandaloneAgentComputerReply>;
+    detachComputer(command: ComputerAttachmentInput, principal: TenantPrincipal, tenantId?: TenantId): Promise<StandaloneAgentComputerReply>;
     /** The owner HTTP read uses the same projection as direct discovery. */
-    readAgentComputers(agentId: string, principal: OysterPrincipal, tenantId?: TenantId): Promise<StandaloneAgentComputerReply>;
+    readAgentComputers(agentId: string, principal: TenantPrincipal, tenantId?: TenantId): Promise<StandaloneAgentComputerReply>;
     /** Every captured native call rechecks the exact live attachment and credential owner. */
     admitAgentComputer(captured: Pick<AgentComputerConnection, "scopeId" | "agentId" | "attachment">, tenantId: TenantId): Promise<Omit<ComputerGrant, "egress">>;
-    list(): readonly AgentEntry[];
+    list(options?: Readonly<{
+        archived?: boolean;
+    }>): readonly AgentEntry[];
     has(agentId: string): boolean;
     /** Resolve the existing recorded creator for host-side owner admission. */
     readCreator(agentId: string): string | null;
+    /** Immutable creating Agent, distinct from the human credential owner. */
+    createdBy(agentId: string): string | null;
     /** Owner-only rename; refuses a name already held by another Agent. */
-    rename(agentId: string, name: string, principal: OysterPrincipal): AgentEntry | Readonly<{
+    rename(agentId: string, name: string, principal: TenantPrincipal): AgentEntry | Readonly<{
         error: "not_found" | "name_taken" | "not_granted";
     }>;
     /** Owner-only avatar change; the Agent wears it in every App and list. */
-    setAvatar(agentId: string, avatar: Avatar, principal: OysterPrincipal): AgentEntry | Readonly<{
+    setAvatar(agentId: string, avatar: Avatar, principal: TenantPrincipal): AgentEntry | Readonly<{
         error: "not_found" | "not_granted";
     }>;
-    create(name: string, requestId: string, principal: OysterPrincipal, actor: AgentPolicyActor, avatar?: Avatar, createdBy?: string | null): AgentEntry & {
+    create(name: string, requestId: string, principal: TenantPrincipal, actor: AgentPolicyActor, avatar?: Avatar, createdBy?: string | null): AgentEntry & {
         policyRevision: string | null;
     };
     private writePolicy;
@@ -247,7 +260,7 @@ export declare class AgentDirectory extends DurableObject<StandaloneAgentEnv> {
         kind: "agent";
     }>, tenantId?: TenantId): Promise<AppToolPolicy | null>;
     /** Only direct human approval records an authenticated canonical grantor. */
-    approveAppToolPolicy(agentId: string, principal: OysterPrincipal, level: AppToolPolicy["level"], expectedRevision: string | null, actor: AgentPolicyActor, tenantId: TenantId): Promise<Awaited<ReturnType<OysterAgents["approveAppToolPolicy"]>>>;
+    approveAppToolPolicy(agentId: string, principal: TenantPrincipal, level: AppToolPolicy["level"], expectedRevision: string | null, actor: AgentPolicyActor, tenantId: TenantId): Promise<Awaited<ReturnType<OysterAgents["approveAppToolPolicy"]>>>;
     visit(agentId: string, sessionId: string): void;
     visits(): readonly Readonly<{
         agentId: string;
@@ -271,9 +284,9 @@ export declare const agentFrameMethods: {
                 readonly items: readonly ({
                     readonly agentId: string;
                     readonly sessionId: string;
-                    readonly createdAt: number;
                     readonly title: string;
-                    readonly state: "done" | "running" | "errored" | "needs_you";
+                    readonly state: "running" | "done" | "errored" | "needs_you";
+                    readonly createdAt: number;
                     readonly lastActivityAt: number;
                     readonly triggerId?: string | undefined;
                     readonly settledAt?: number | undefined;
@@ -317,6 +330,155 @@ export declare const agentFrameMethods: {
         };
     };
     AGENTS: {
+        schedules: {
+            decodeArgs: (raw: readonly unknown[]) => [{
+                limit: number;
+                agentId: string;
+                after?: {
+                    agentId: string;
+                    kind: "almanac" | "loop";
+                    after?: string | undefined;
+                } | undefined;
+            }];
+            decodeResult: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => {
+                readonly items: readonly ({
+                    readonly agentId: string;
+                    readonly kind: "almanac";
+                    readonly schedule: {
+                        readonly id: string;
+                        readonly sessionId: string;
+                        readonly prompt: string;
+                        readonly cron: {
+                            readonly expression: string;
+                            readonly timeZone: string;
+                        } | null;
+                        readonly nextDueAt: number;
+                        readonly state: "active" | "paused" | "cancelled" | "finished";
+                        readonly lastCommandId: string | null;
+                        readonly lastError: string | null;
+                        readonly attempt: number;
+                    };
+                } | {
+                    readonly agentId: string;
+                    readonly kind: "loop";
+                    readonly schedule: {
+                        readonly sessionId: string;
+                        readonly loopId: string;
+                        readonly origin: "model" | "human";
+                        readonly expiresAt: number | null;
+                        readonly prompt: string;
+                        readonly mode: "self_paced" | "fixed_interval";
+                        readonly cron: {
+                            readonly expression: string;
+                            readonly timeZone: string;
+                        } | null;
+                        readonly state: "active" | "failed" | "paused" | "cancelled" | "finished";
+                        readonly commandId: string;
+                        readonly reason: string | null;
+                        readonly nextDueAt: number | null;
+                        readonly lastError: string | null;
+                        readonly consecutiveFailures: number;
+                    };
+                })[];
+                readonly next: {
+                    readonly agentId: string;
+                    readonly kind: "almanac" | "loop";
+                    readonly after?: string | undefined;
+                } | null;
+            };
+            requiredOperations: () => string[];
+            requestedResource: (raw: readonly unknown[]) => {
+                kind: string;
+                id: string;
+            };
+        };
+        pauseSchedule: {
+            decodeArgs: (raw: readonly unknown[]) => [{
+                kind: "almanac";
+                agentId: string;
+                scheduleId: string;
+            } | {
+                kind: "loop";
+                agentId: string;
+                sessionId: string;
+                loopId: string;
+            }];
+            decodeResult: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => {
+                readonly agentId: string;
+                readonly kind: "almanac";
+                readonly scheduleId: string;
+                readonly state: "active" | "paused" | "cancelled" | "finished";
+            } | {
+                readonly agentId: string;
+                readonly kind: "loop";
+                readonly sessionId: string;
+                readonly loopId: string;
+                readonly state: "active" | "failed" | "paused" | "cancelled" | "finished";
+            };
+            requiredOperations: () => string[];
+            requestedResource: (raw: readonly unknown[]) => {
+                kind: string;
+                id: string;
+            };
+        };
+        resumeSchedule: {
+            decodeArgs: (raw: readonly unknown[]) => [{
+                kind: "almanac";
+                agentId: string;
+                scheduleId: string;
+            } | {
+                kind: "loop";
+                agentId: string;
+                sessionId: string;
+                loopId: string;
+            }];
+            decodeResult: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => {
+                readonly agentId: string;
+                readonly kind: "almanac";
+                readonly scheduleId: string;
+                readonly state: "active" | "paused" | "cancelled" | "finished";
+            } | {
+                readonly agentId: string;
+                readonly kind: "loop";
+                readonly sessionId: string;
+                readonly loopId: string;
+                readonly state: "active" | "failed" | "paused" | "cancelled" | "finished";
+            };
+            requiredOperations: () => string[];
+            requestedResource: (raw: readonly unknown[]) => {
+                kind: string;
+                id: string;
+            };
+        };
+        deleteSchedule: {
+            decodeArgs: (raw: readonly unknown[]) => [{
+                kind: "almanac";
+                agentId: string;
+                scheduleId: string;
+            } | {
+                kind: "loop";
+                agentId: string;
+                sessionId: string;
+                loopId: string;
+            }];
+            decodeResult: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => {
+                readonly agentId: string;
+                readonly kind: "almanac";
+                readonly scheduleId: string;
+                readonly state: "active" | "paused" | "cancelled" | "finished";
+            } | {
+                readonly agentId: string;
+                readonly kind: "loop";
+                readonly sessionId: string;
+                readonly loopId: string;
+                readonly state: "active" | "failed" | "paused" | "cancelled" | "finished";
+            };
+            requiredOperations: () => string[];
+            requestedResource: (raw: readonly unknown[]) => {
+                kind: string;
+                id: string;
+            };
+        };
         send: {
             decodeArgs: (raw: readonly unknown[]) => [{
                 agentId: string;
@@ -331,6 +493,10 @@ export declare const agentFrameMethods: {
                 sessionId?: string;
             }>;
             requiredOperations: () => string[];
+            requestedResource: (raw: readonly unknown[]) => {
+                kind: string;
+                id: string;
+            };
         };
     };
 };