@fungi.computer/trellis 0.4.0 → 0.6.0

package/README.md

@@ -25,6 +25,13 @@ Workflows, and its steps call the same App methods your agents use.
 - Arm a published version in **Triggers** to start on a schedule, on an App
   event such as a Bonsai push or merge, or from a webhook, and have it report
   its ending to one of your chats.
+- Open **Schedules** from the scope picker without selecting a workflow or
+  granting Git access. It shows this installation's Workflow registrations and
+  the Almanac reminders and Session Loops of Agents visible to Trellis. Pause
+  and Delete call the original owners and retain accepted work and history.
+  Agent read and management approval are independent. Missing or refused owners,
+  incomplete pages and unavailable private Local coverage are labelled, not
+  counted as empty schedules. Publication-context arming stays in Triggers.
 - Start from **Templates**: Bonsai checks (run `npm test` on each Change and
   report the result), Build on merge, Review a result, Storyboard (panels from
   Prints with a review per beat) and Storyboard + Save to git.

package/backend/agent-schedule-methods.ts

@@ -0,0 +1,59 @@
+import { defineAppMethod } from "@fungi.computer/agar/backend-definition";
+import {
+  listAgentSchedulesInputSchema,
+  agentScheduleTargetSchema,
+  agentSchedulesReplySchema,
+  agentScheduleControlReplySchema,
+  decodeAgentSchedulePage,
+  decodeAgentScheduleControl,
+} from "../shared/agent-schedules.js";
+import type { WorkflowMethodContext } from "./methods.js";
+
+const granted = (context: WorkflowMethodContext) => {
+  if (!context.env.AGENTS)
+    throw new Error("Agent schedules are unavailable from this host");
+  return context.env.AGENTS;
+};
+
+export const agentScheduleMethods = {
+  listAgentSchedules: defineAppMethod({
+    description:
+      "Read one bounded native schedule page for an authorized Agent.",
+    effect: "read",
+    requires: ["agent.read"],
+    input: listAgentSchedulesInputSchema,
+    output: agentSchedulesReplySchema,
+    handler: async (input, context: WorkflowMethodContext) =>
+      decodeAgentSchedulePage(await granted(context).schedules(input)),
+  }),
+  pauseAgentSchedule: defineAppMethod({
+    description:
+      "Pause future occurrences of the exact listed Agent schedule, retaining accepted work.",
+    effect: "write",
+    requires: ["agent.manage"],
+    input: agentScheduleTargetSchema,
+    output: agentScheduleControlReplySchema,
+    handler: async (input, context: WorkflowMethodContext) =>
+      decodeAgentScheduleControl(await granted(context).pauseSchedule(input)),
+  }),
+  resumeAgentSchedule: defineAppMethod({
+    description:
+      "Resume future occurrences of the exact listed Agent schedule, retaining accepted work.",
+    effect: "write",
+    requires: ["agent.manage"],
+    input: agentScheduleTargetSchema,
+    output: agentScheduleControlReplySchema,
+    handler: async (input, context: WorkflowMethodContext) =>
+      decodeAgentScheduleControl(await granted(context).resumeSchedule(input)),
+  }),
+  deleteAgentSchedule: defineAppMethod({
+    description:
+      "Cancel future occurrences of the exact listed Agent schedule, retaining accepted work and history.",
+    effect: "write",
+    requires: ["agent.manage"],
+    input: agentScheduleTargetSchema,
+    output: agentScheduleControlReplySchema,
+    handler: async (input, context: WorkflowMethodContext) =>
+      decodeAgentScheduleControl(await granted(context).deleteSchedule(input)),
+  }),
+};

package/backend/library-methods.ts

@@ -197,6 +197,7 @@ export const libraryMethods = {
       "workflow.arm",
       "media.generation",
       "computer.writeFile",
+      "agent.manage",
     ],
     input: z.strictObject({}),
     output: z.strictObject({ more: z.boolean() }),

package/backend/methods.ts

@@ -7,6 +7,11 @@ import type { BackgroundBinding } from "@fungi.computer/puffball/background-repl
 import type { GitBinding } from "@fungi.computer/agar/git";
 import type { WorkflowIndexes } from "./indexes.js";
 import { scheduleMethods } from "./schedule-methods.js";
+import { agentScheduleMethods } from "./agent-schedule-methods.js";
+import type {
+  listAgentSchedulesInputSchema,
+  agentScheduleTargetSchema,
+} from "../shared/agent-schedules.js";
 import { toolFamilyMethods } from "./tool-family.js";
 import { libraryMethods } from "./library-methods.js";
 import * as Schema from "effect/Schema";
@@ -18,6 +23,7 @@ import {
 import {
   chatsReplySchema,
   type WorkflowTriggerArmTarget,
+  type ScheduleListInput,
   answerReviewReply,
   cancelReplySchema,
   catalogInputSchema,
@@ -33,6 +39,20 @@ const inboxPage = z.object({ items: z.array(z.json()).max(200) });
 export type WorkflowMethodContext = Readonly<{
   indexes?: WorkflowIndexes;
   env: Readonly<{
+    AGENTS?: Readonly<{
+      schedules(
+        input: z.output<typeof listAgentSchedulesInputSchema>,
+      ): Promise<typeof Schema.Json.Type>;
+      pauseSchedule(
+        input: z.output<typeof agentScheduleTargetSchema>,
+      ): Promise<typeof Schema.Json.Type>;
+      resumeSchedule(
+        input: z.output<typeof agentScheduleTargetSchema>,
+      ): Promise<typeof Schema.Json.Type>;
+      deleteSchedule(
+        input: z.output<typeof agentScheduleTargetSchema>,
+      ): Promise<typeof Schema.Json.Type>;
+    }>;
     GIT?: GitBinding;
     /** The member's Inbox, read only to offer chats for run reports. */
     INBOX?: Readonly<{
@@ -55,7 +75,13 @@ export type WorkflowMethodContext = Readonly<{
       disarmSchedule(input: {
         scheduleId: string;
       }): Promise<typeof Schema.Json.Type>;
-      schedules(input: Record<string, never>): Promise<typeof Schema.Json.Type>;
+      pauseSchedule(input: {
+        scheduleId: string;
+      }): Promise<typeof Schema.Json.Type>;
+      resumeSchedule(input: {
+        scheduleId: string;
+      }): Promise<typeof Schema.Json.Type>;
+      schedules(input: ScheduleListInput): Promise<typeof Schema.Json.Type>;
       catalog(input: {
         installationId?: string | undefined;
       }): Promise<typeof Schema.Json.Type>;
@@ -133,6 +159,7 @@ export const appBackend = defineAppBackend<WorkflowMethodContext>({
           : { error: "not_granted" },
     }),
     ...scheduleMethods,
+    ...agentScheduleMethods,
     listChats: defineAppMethod({
       description:
         "List your existing chats (Agent Sessions) that a run or trigger may report its result to.",

package/backend/schedule-methods.ts

@@ -1,9 +1,14 @@
 import {
   triggerTargetSchema,
   scheduleArmReplySchema,
+  schedulePauseInputSchema,
+  schedulePauseReplySchema,
+  scheduleResumeInputSchema,
+  scheduleResumeReplySchema,
   triggerDisarmReplySchema,
   schedulesReplySchema,
   scheduleDisarmInputSchema,
+  scheduleListInputSchema,
   eventDisarmInputSchema,
   triggerListInputSchema,
   eventArmReplySchema,
@@ -59,6 +64,28 @@ export const scheduleMethods = {
       );
     },
   }),
+  pause: defineAppMethod({
+    description: "Pause future occurrences of an armed Workflow schedule.",
+    effect: "write",
+    requires: ["workflow.run", "workflow.arm"],
+    input: schedulePauseInputSchema,
+    output: schedulePauseReplySchema,
+    handler: async (input, context: WorkflowMethodContext) =>
+      schedulePauseReplySchema.parse(
+        await granted(context).pauseSchedule(input),
+      ),
+  }),
+  resume: defineAppMethod({
+    description: "Resume future occurrences of a paused Workflow schedule.",
+    effect: "write",
+    requires: ["workflow.run", "workflow.arm"],
+    input: scheduleResumeInputSchema,
+    output: scheduleResumeReplySchema,
+    handler: async (input, context: WorkflowMethodContext) =>
+      scheduleResumeReplySchema.parse(
+        await granted(context).resumeSchedule(input),
+      ),
+  }),
   disarm: defineAppMethod({
     description: "Cancel an armed Workflow schedule.",
     effect: "write",
@@ -72,13 +99,13 @@ export const scheduleMethods = {
   }),
   listTriggers: defineAppMethod({
     description:
-      "List this installation's schedules, next run times and paused reasons.",
+      "Read one bounded page of this installation's schedules, next run times and paused reasons.",
     effect: "read",
     requires: ["workflow.run"],
-    input: triggerListInputSchema,
+    input: scheduleListInputSchema,
     output: schedulesReplySchema,
-    handler: async (_input, context: WorkflowMethodContext) =>
-      schedulesReplySchema.parse(await granted(context).schedules({})),
+    handler: async (input, context: WorkflowMethodContext) =>
+      schedulesReplySchema.parse(await granted(context).schedules(input)),
   }),
   armEventTrigger: defineAppMethod({
     description:

package/dist/backend/agent-schedule-methods.js

@@ -0,0 +1,41 @@
+import { defineAppMethod } from "@fungi.computer/agar/backend-definition";
+import { listAgentSchedulesInputSchema, agentScheduleTargetSchema, agentSchedulesReplySchema, agentScheduleControlReplySchema, decodeAgentSchedulePage, decodeAgentScheduleControl, } from "../shared/agent-schedules.js";
+const granted = (context) => {
+    if (!context.env.AGENTS)
+        throw new Error("Agent schedules are unavailable from this host");
+    return context.env.AGENTS;
+};
+export const agentScheduleMethods = {
+    listAgentSchedules: defineAppMethod({
+        description: "Read one bounded native schedule page for an authorized Agent.",
+        effect: "read",
+        requires: ["agent.read"],
+        input: listAgentSchedulesInputSchema,
+        output: agentSchedulesReplySchema,
+        handler: async (input, context) => decodeAgentSchedulePage(await granted(context).schedules(input)),
+    }),
+    pauseAgentSchedule: defineAppMethod({
+        description: "Pause future occurrences of the exact listed Agent schedule, retaining accepted work.",
+        effect: "write",
+        requires: ["agent.manage"],
+        input: agentScheduleTargetSchema,
+        output: agentScheduleControlReplySchema,
+        handler: async (input, context) => decodeAgentScheduleControl(await granted(context).pauseSchedule(input)),
+    }),
+    resumeAgentSchedule: defineAppMethod({
+        description: "Resume future occurrences of the exact listed Agent schedule, retaining accepted work.",
+        effect: "write",
+        requires: ["agent.manage"],
+        input: agentScheduleTargetSchema,
+        output: agentScheduleControlReplySchema,
+        handler: async (input, context) => decodeAgentScheduleControl(await granted(context).resumeSchedule(input)),
+    }),
+    deleteAgentSchedule: defineAppMethod({
+        description: "Cancel future occurrences of the exact listed Agent schedule, retaining accepted work and history.",
+        effect: "write",
+        requires: ["agent.manage"],
+        input: agentScheduleTargetSchema,
+        output: agentScheduleControlReplySchema,
+        handler: async (input, context) => decodeAgentScheduleControl(await granted(context).deleteSchedule(input)),
+    }),
+};

package/dist/backend/library-methods.js

@@ -145,6 +145,7 @@ export const libraryMethods = {
             "workflow.arm",
             "media.generation",
             "computer.writeFile",
+            "agent.manage",
         ],
         input: z.strictObject({}),
         output: z.strictObject({ more: z.boolean() }),

package/dist/backend/methods.js

@@ -3,6 +3,7 @@ import * as z from "zod";
 import { memberInboxItemSchema } from "@fungi.computer/agar/inbox";
 import { catalogReplySchema as catalogReply } from "./catalog.js";
 import { scheduleMethods } from "./schedule-methods.js";
+import { agentScheduleMethods } from "./agent-schedule-methods.js";
 import { toolFamilyMethods } from "./tool-family.js";
 import { libraryMethods } from "./library-methods.js";
 import * as Schema from "effect/Schema";
@@ -65,6 +66,7 @@ export const appBackend = defineAppBackend({
                 : { error: "not_granted" },
         }),
         ...scheduleMethods,
+        ...agentScheduleMethods,
         listChats: defineAppMethod({
             description: "List your existing chats (Agent Sessions) that a run or trigger may report its result to.",
             effect: "read",

package/dist/backend/schedule-methods.js

@@ -1,4 +1,4 @@
-import { triggerTargetSchema, scheduleArmReplySchema, triggerDisarmReplySchema, schedulesReplySchema, scheduleDisarmInputSchema, eventDisarmInputSchema, triggerListInputSchema, eventArmReplySchema, eventTriggersReplySchema, } from "@fungi.computer/workflows-wire";
+import { triggerTargetSchema, scheduleArmReplySchema, schedulePauseInputSchema, schedulePauseReplySchema, scheduleResumeInputSchema, scheduleResumeReplySchema, triggerDisarmReplySchema, schedulesReplySchema, scheduleDisarmInputSchema, scheduleListInputSchema, eventDisarmInputSchema, triggerListInputSchema, eventArmReplySchema, eventTriggersReplySchema, } from "@fungi.computer/workflows-wire";
 import { defineAppMethod } from "@fungi.computer/agar/backend-definition";
 import { createWorkflowLibrary } from "./library.js";
 import { readWorkflowCatalog } from "./catalog.js";
@@ -41,6 +41,22 @@ export const scheduleMethods = {
             return scheduleArmReplySchema.parse(await workflows.armSchedule({ ...input, digest: stored.digest }));
         },
     }),
+    pause: defineAppMethod({
+        description: "Pause future occurrences of an armed Workflow schedule.",
+        effect: "write",
+        requires: ["workflow.run", "workflow.arm"],
+        input: schedulePauseInputSchema,
+        output: schedulePauseReplySchema,
+        handler: async (input, context) => schedulePauseReplySchema.parse(await granted(context).pauseSchedule(input)),
+    }),
+    resume: defineAppMethod({
+        description: "Resume future occurrences of a paused Workflow schedule.",
+        effect: "write",
+        requires: ["workflow.run", "workflow.arm"],
+        input: scheduleResumeInputSchema,
+        output: scheduleResumeReplySchema,
+        handler: async (input, context) => scheduleResumeReplySchema.parse(await granted(context).resumeSchedule(input)),
+    }),
     disarm: defineAppMethod({
         description: "Cancel an armed Workflow schedule.",
         effect: "write",
@@ -50,12 +66,12 @@ export const scheduleMethods = {
         handler: async (input, context) => triggerDisarmReplySchema.parse(await granted(context).disarmSchedule(input)),
     }),
     listTriggers: defineAppMethod({
-        description: "List this installation's schedules, next run times and paused reasons.",
+        description: "Read one bounded page of this installation's schedules, next run times and paused reasons.",
         effect: "read",
         requires: ["workflow.run"],
-        input: triggerListInputSchema,
+        input: scheduleListInputSchema,
         output: schedulesReplySchema,
-        handler: async (_input, context) => schedulesReplySchema.parse(await granted(context).schedules({})),
+        handler: async (input, context) => schedulesReplySchema.parse(await granted(context).schedules(input)),
     }),
     armEventTrigger: defineAppMethod({
         description: "Arm a published Workflow App-event trigger as you on the pinned Computer. An optional delivery chat receives every run's ending.",

package/dist/shared/agent-schedules.js

@@ -0,0 +1,12 @@
+import * as S from "effect/Schema";
+import * as z from "zod";
+import { agentScheduleListInputSchema, agentScheduleTargetSchema, agentSchedulePageSchema, agentScheduleControlReceiptSchema, } from "@fungi.computer/shiitake-extensions/schedules";
+/** App-method arguments retain the native owner's page and identity grammar. */
+export const listAgentSchedulesInputSchema = agentScheduleListInputSchema.extend({
+    agentId: agentScheduleTargetSchema.options[0].shape.agentId,
+});
+export { agentScheduleTargetSchema };
+export const agentSchedulesReplySchema = z.fromJSONSchema(S.toJsonSchemaDocument(agentSchedulePageSchema).schema);
+export const agentScheduleControlReplySchema = z.fromJSONSchema(S.toJsonSchemaDocument(agentScheduleControlReceiptSchema).schema);
+export const decodeAgentSchedulePage = S.decodeUnknownSync(agentSchedulePageSchema, { onExcessProperty: "error" });
+export const decodeAgentScheduleControl = S.decodeUnknownSync(agentScheduleControlReceiptSchema, { onExcessProperty: "error" });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fungi.computer/trellis",
   "description": "Trellis: build and run workflows of App methods, an App for Oyster",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "author": "Levi <levi@technomancy.dev>",
   "type": "module",
   "exports": {
@@ -14,25 +14,27 @@
     "./run-timeline": "./src/runs/public.ts"
   },
   "dependencies": {
-    "@fungi.computer/puffball": "0.2.0",
+    "@fungi.computer/puffball": "0.4.0",
+    "@fungi.computer/shiitake-extensions": "0.6.0",
     "@cfworker/json-schema": "4.1.1",
-    "@fungi.computer/agar": "0.5.0",
-    "@fungi.computer/caps": "0.4.0",
+    "@fungi.computer/agar": "0.6.1",
+    "@fungi.computer/caps": "0.6.0",
     "@fungi.computer/stipe": "0.1.0",
     "@xyflow/react": "12.12.0",
     "react": "18.3.1",
     "react-dom": "18.3.1",
-    "@fungi.computer/braid": "0.2.4",
+    "@fungi.computer/braid": "0.4.0",
     "effect": "4.0.2",
-    "@fungi.computer/sigils": "0.2.0",
+    "@fungi.computer/sigils": "0.2.1",
     "lucide-react": "0.460.0",
     "zod": "4.4.3",
-    "@fungi.computer/workflows-wire": "0.2.4",
+    "@fungi.computer/workflows-wire": "0.4.0",
     "@fungi.computer/cairn": "0.1.0",
     "@fungi.computer/watchdog": "0.1.0",
     "@fungi.computer/maosaico": "0.1.0"
   },
   "devDependencies": {
+    "@fungi.computer/sprite": "0.2.0",
     "@cloudflare/workers-types": "5.20260828.1",
     "@ladle/react": "5.1.1",
     "@tailwindcss/vite": "4.2.1",
@@ -94,6 +96,8 @@
         "workflow.arm",
         "git.repository",
         "agent.read",
+        "agent.list",
+        "agent.manage",
         "apps.open"
       ],
       "handlers": [],
@@ -118,6 +122,8 @@
               "cancel",
               "answerReview",
               "armSchedule",
+              "pauseSchedule",
+              "resumeSchedule",
               "disarmSchedule",
               "schedules",
               "armEventTrigger",
@@ -131,6 +137,15 @@
             "operations": [
               "page"
             ]
+          },
+          {
+            "name": "AGENTS",
+            "operations": [
+              "schedules",
+              "pauseSchedule",
+              "resumeSchedule",
+              "deleteSchedule"
+            ]
           }
         ]
       }
@@ -169,14 +184,15 @@
     "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p backend/tsconfig.json --noEmit",
     "lint": "eslint src test backend --max-warnings=0",
     "rebuild-copies": "node --import tsx scripts/rebuild-copies.mjs",
-    "test": "node --import tsx --test test/*.test.ts test/storyboard-method-pins.test.mjs && vitest run --config vitest.config.mjs test/main.test.tsx test/inspector.test.tsx test/use-draft.test.tsx test/review-dock.test.tsx test/runs.test.tsx test/runs-list.test.tsx test/timeline-items.test.tsx test/version-history.test.tsx test/portable-share.test.tsx test/review-output.test.tsx test/publish-controls.test.tsx",
+    "test": "node --import tsx --test test/*.test.ts test/storyboard-method-pins.test.mjs test/schedule-pages.test.mjs && vitest run --config vitest.config.mjs test/main.test.tsx test/inspector.test.tsx test/use-draft.test.tsx test/review-dock.test.tsx test/runs.test.tsx test/runs-list.test.tsx test/timeline-items.test.tsx test/version-history.test.tsx test/portable-share.test.tsx test/review-output.test.tsx test/publish-controls.test.tsx test/schedules.test.tsx",
     "test:readiness:browser": "node test/editor-w4.browser.mjs && node test/readiness.browser.mjs",
     "test:browser": "node test/workflows.browser.mjs",
+    "test:schedules:browser": "node test/schedules.browser.mjs",
     "test:storyboard:browser": "node test/storyboard.browser.mjs",
     "test:timeline:browser": "node test/run-timeline.browser.mjs",
     "format:check": "node ../../tooling/repository/scripts/format-package-check.mjs",
     "lint:anti-slop": "node ../../tooling/repository/scripts/lint-package-anti-slop.mjs",
-    "test:nightly": "WORKFLOW_EVIDENCE=.botanical/workflows bash ../../.agents/skills/orchestrate-multi-lane-work/scripts/run-proof.sh node test/workflows.browser.mjs && pnpm run test:history:browser",
+    "test:nightly": "WORKFLOW_EVIDENCE=.botanical/workflows bash ../../tooling/proof-runner/run-proof.sh node test/workflows.browser.mjs && pnpm run test:history:browser",
     "test:editor:browser": "node test/editor.browser.mjs && node test/editor-w4.browser.mjs",
     "test:generic:browser": "node test/workflows-generic.browser.mjs",
     "test:nested:browser": "node test/nested-fields.browser.mjs",

package/shared/agent-schedules.ts

@@ -0,0 +1,30 @@
+import * as S from "effect/Schema";
+import * as z from "zod";
+import {
+  agentScheduleListInputSchema,
+  agentScheduleTargetSchema,
+  agentSchedulePageSchema,
+  agentScheduleControlReceiptSchema,
+} from "@fungi.computer/shiitake-extensions/schedules";
+
+/** App-method arguments retain the native owner's page and identity grammar. */
+export const listAgentSchedulesInputSchema =
+  agentScheduleListInputSchema.extend({
+    agentId: agentScheduleTargetSchema.options[0].shape.agentId,
+  });
+export { agentScheduleTargetSchema };
+
+export const agentSchedulesReplySchema = z.fromJSONSchema(
+  S.toJsonSchemaDocument(agentSchedulePageSchema).schema,
+);
+export const agentScheduleControlReplySchema = z.fromJSONSchema(
+  S.toJsonSchemaDocument(agentScheduleControlReceiptSchema).schema,
+);
+export const decodeAgentSchedulePage = S.decodeUnknownSync(
+  agentSchedulePageSchema,
+  { onExcessProperty: "error" },
+);
+export const decodeAgentScheduleControl = S.decodeUnknownSync(
+  agentScheduleControlReceiptSchema,
+  { onExcessProperty: "error" },
+);