@fungi.computer/oyster 0.24.0 → 0.26.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. package/dist/agent-instructions.d.ts +35 -0
  2. package/dist/agent-instructions.js +42 -0
  3. package/dist/agents.d.ts +14 -0
  4. package/dist/agents.js +43 -1
  5. package/dist/app-builds.d.ts +4 -2
  6. package/dist/app-builds.js +14 -0
  7. package/dist/apps/catalog.d.ts +11 -0
  8. package/dist/apps/catalog.js +1 -0
  9. package/dist/apps/gate.d.ts +2 -2
  10. package/dist/apps/installation.d.ts +7 -7
  11. package/dist/apps/permissions.d.ts +5 -5
  12. package/dist/boot-host-script.js +1 -1
  13. package/dist/browser/boot-once.d.ts +84 -0
  14. package/dist/browser/boot-once.js +48 -0
  15. package/dist/build/build-memory.d.ts +13 -0
  16. package/dist/build/build-memory.js +29 -0
  17. package/dist/build/candidate-cli.mjs +25 -2
  18. package/dist/build/local-build.js +4 -5
  19. package/dist/cloudflare.d.ts +2 -2
  20. package/dist/cloudflare.js +3 -0
  21. package/dist/computer-control-port.d.ts +2 -0
  22. package/dist/embed-metafiles.js +2 -2
  23. package/dist/embed-scripts.js +1 -1
  24. package/dist/installation-operations.d.ts +8 -8
  25. package/dist/mcp.d.ts +26 -0
  26. package/dist/mcp.js +12 -2
  27. package/dist/page-script.js +2 -2
  28. package/dist/release.d.ts +5 -0
  29. package/dist/standalone/agents.d.ts +6 -0
  30. package/dist/standalone/agents.js +46 -3
  31. package/dist/standalone/app-set.d.ts +4 -3
  32. package/dist/standalone/app-set.js +9 -5
  33. package/dist/standalone/computer-control.js +7 -1
  34. package/dist/standalone/computer-fleet.d.ts +5 -0
  35. package/dist/standalone/computer-skill-source.d.ts +20 -0
  36. package/dist/standalone/computer-skill-source.js +165 -0
  37. package/dist/standalone/computer.d.ts +7 -4
  38. package/dist/standalone/computer.js +62 -3
  39. package/dist/standalone/install-apps-cli.js +1 -1
  40. package/dist/standalone/media.d.ts +1 -1
  41. package/dist/standalone/registry.d.ts +3 -0
  42. package/dist/standalone/registry.js +1 -1
  43. package/dist/standalone/workflow-host.d.ts +5 -5
  44. package/dist/standalone/workflow-trigger-host.d.ts +1 -1
  45. package/docs/api/agents.md +18 -0
  46. package/docs/api/apps.md +148 -131
  47. package/docs/api/browser/boot-once.md +169 -0
  48. package/docs/api/build-contract.md +27 -21
  49. package/docs/api/build.md +70 -69
  50. package/docs/api/cloudflare.md +4 -1
  51. package/docs/api/git.md +3 -3
  52. package/docs/api/host.md +91 -85
  53. package/docs/api/mcp.md +68 -62
  54. package/docs/api/modules.md +1 -0
  55. package/docs/api/workers-git.md +7 -7
  56. package/docs/api/workers.md +24 -21
  57. package/package.json +25 -17
@@ -0,0 +1,35 @@
1
+ import { z } from "zod";
2
+ /**
3
+ * The standing instructions an owner gave one Agent. They live in the Agent's
4
+ * own store, so every turn reads them where it runs. The owner's text is
5
+ * appended after Oyster's fixed instructions and never replaces them.
6
+ */
7
+ /** The SQL an Agent's own store offers: the one statement call both hosts share. */
8
+ export type InstructionsSql = Readonly<{
9
+ exec: (statement: string, ...bindings: (ArrayBuffer | string | number | null)[]) => Readonly<{
10
+ toArray: () => readonly unknown[];
11
+ }>;
12
+ }>;
13
+ declare const storedRow: z.ZodObject<{
14
+ instructions: z.ZodString;
15
+ version: z.ZodNumber;
16
+ }, z.core.$strict>;
17
+ /** What the owner wrote, and which edit of it this is; 0 means never written. */
18
+ export type StoredAgentInstructions = z.infer<typeof storedRow>;
19
+ /** Open the Agent's one instructions row in its own SQLite. */
20
+ export declare function createAgentInstructions(sql: InstructionsSql): {
21
+ read(): StoredAgentInstructions;
22
+ /** Replace the text, one version up; empty text clears it. */
23
+ write(instructions: string): StoredAgentInstructions;
24
+ };
25
+ /** One turn's instructions: a revision that names them, and their text. */
26
+ export type LoadedInstructions = Readonly<{
27
+ revision: string;
28
+ text: string;
29
+ }>;
30
+ /**
31
+ * The fixed instructions, then the owner's after them. A revision names both,
32
+ * so an edit is seen by the next turn and by nothing already running.
33
+ */
34
+ export declare function withOwnerInstructions(fixed: LoadedInstructions, owner: StoredAgentInstructions): LoadedInstructions;
35
+ export {};
@@ -0,0 +1,42 @@
1
+ import { z } from "zod";
2
+ import { appAgentInstructionsMaxLength } from "@fungi.computer/agar";
3
+ const storedRow = z.strictObject({
4
+ instructions: z.string().max(appAgentInstructionsMaxLength),
5
+ version: z.number().int().nonnegative(),
6
+ });
7
+ /** Open the Agent's one instructions row in its own SQLite. */
8
+ export function createAgentInstructions(sql) {
9
+ sql.exec("CREATE TABLE IF NOT EXISTS agent_instructions (id INTEGER PRIMARY KEY CHECK (id = 1), instructions TEXT NOT NULL, version INTEGER NOT NULL) STRICT");
10
+ return {
11
+ read() {
12
+ const row = sql
13
+ .exec("SELECT instructions, version FROM agent_instructions")
14
+ .toArray()[0];
15
+ return row === undefined
16
+ ? { instructions: "", version: 0 }
17
+ : storedRow.parse(row);
18
+ },
19
+ /** Replace the text, one version up; empty text clears it. */
20
+ write(instructions) {
21
+ const checked = z
22
+ .string()
23
+ .max(appAgentInstructionsMaxLength)
24
+ .parse(instructions);
25
+ sql.exec("INSERT INTO agent_instructions(id, instructions, version) VALUES(1, ?, 1) ON CONFLICT(id) DO UPDATE SET instructions = excluded.instructions, version = version + 1", checked);
26
+ return this.read();
27
+ },
28
+ };
29
+ }
30
+ /**
31
+ * The fixed instructions, then the owner's after them. A revision names both,
32
+ * so an edit is seen by the next turn and by nothing already running.
33
+ */
34
+ export function withOwnerInstructions(fixed, owner) {
35
+ const text = owner.instructions.trim();
36
+ if (text.length === 0)
37
+ return fixed;
38
+ return {
39
+ revision: `${fixed.revision}+owner-${String(owner.version)}`,
40
+ text: `${fixed.text}\n\nYour owner's standing instructions. Follow them on every turn, within the rules above:\n${text}`,
41
+ };
42
+ }
package/dist/agents.d.ts CHANGED
@@ -140,6 +140,20 @@ export type OysterAgents = Readonly<{
140
140
  }>>;
141
141
  /** Owner-only, secret-free Agent default; an unknown Agent cannot be configured. */
142
142
  readModelChoice(agentId: string): Promise<AgentModelChoice | null>;
143
+ /** Owner-only read of the standing instructions this Agent follows on every turn. */
144
+ readInstructions(agentId: string, principal: TenantPrincipal): Promise<Readonly<{
145
+ agentId: string;
146
+ instructions: string;
147
+ }> | Readonly<{
148
+ error: "not_found" | "not_granted";
149
+ }>>;
150
+ /** Owner-only replacement of them; empty clears. Appended after the host's fixed instructions. */
151
+ setInstructions(agentId: string, instructions: string, principal: TenantPrincipal): Promise<Readonly<{
152
+ agentId: string;
153
+ instructions: string;
154
+ }> | Readonly<{
155
+ error: "not_found" | "not_granted";
156
+ }>>;
143
157
  /** Parse the owner's JSON through the deployable Agent's model preference schema. */
144
158
  decodeModelChoice(json: string): AgentModelChoice | null;
145
159
  /** Persist a supported model and source reference for this Agent, or return an explicit refusal. */
package/dist/agents.js CHANGED
@@ -6,7 +6,7 @@ import { agentAvatarSchema } from "./agent-avatars.js";
6
6
  import { computerTargetParam } from "./computer-target.js";
7
7
  import { modelKeyProviderChoices } from "./standalone/model-key-providers.js";
8
8
  import { supportedAgentModels } from "./standalone/agent-model-choice.js";
9
- import { agentAvatar, agentList, agentManage, agentRename, agentSessionRead, agentSessionWrite, agentToolPolicy, } from "@fungi.computer/agar/agents";
9
+ import { agentAvatar, agentInstructions, appAgentInstructionsMaxLength, agentList, agentManage, agentRename, agentSessionRead, agentSessionWrite, agentToolPolicy, } from "@fungi.computer/agar/agents";
10
10
  /** At most this many connections per Agent. */
11
11
  export const maxAgentConnections = 16;
12
12
  /** Owner input for one MCP connection: a guest identifier, an `https:` endpoint and an optional bearer. */
@@ -43,6 +43,9 @@ const renameSchema = Schema.Struct({
43
43
  name: Schema.String.check(Schema.isMinLength(1), Schema.isMaxLength(256)),
44
44
  });
45
45
  const avatarInputSchema = z.object({ avatar: agentAvatarSchema });
46
+ const instructionsInputSchema = z.object({
47
+ instructions: z.string().max(appAgentInstructionsMaxLength),
48
+ });
46
49
  const visitSchema = Schema.Struct({
47
50
  agentId: Schema.String,
48
51
  sessionId: Schema.String,
@@ -108,6 +111,24 @@ export function agentCapabilities(agents) {
108
111
  },
109
112
  },
110
113
  },
114
+ {
115
+ ...shared,
116
+ id: "agent.instructions",
117
+ permission: "agent.instructions",
118
+ version: agentInstructions.version,
119
+ methods: {
120
+ read: {
121
+ kind: "json",
122
+ method: "GET",
123
+ path: "agent-instructions/:agentId",
124
+ },
125
+ set: {
126
+ kind: "json",
127
+ method: "PUT",
128
+ path: "agent-instructions/:agentId",
129
+ },
130
+ },
131
+ },
111
132
  {
112
133
  ...shared,
113
134
  id: "agent.toolPolicy",
@@ -230,6 +251,27 @@ function createAgentRoutes(agents) {
230
251
  if ("error" in result)
231
252
  return refusal(result.error === "not_found" ? 404 : 403, result.error);
232
253
  return Response.json(result);
254
+ })
255
+ .get("/agent-instructions/:agentId", owner("direct-or-app"), async (context, { principal }) => {
256
+ const agentId = context.req.param("agentId");
257
+ if (!agentIdPattern.test(agentId))
258
+ return refusal(404, "No such agent");
259
+ const result = await agents.readInstructions(agentId, principal);
260
+ if ("error" in result)
261
+ return refusal(result.error === "not_found" ? 404 : 403, result.error);
262
+ return Response.json(result);
263
+ })
264
+ .put("/agent-instructions/:agentId", owner("direct-or-app"), async (context, { principal }) => {
265
+ const agentId = context.req.param("agentId");
266
+ if (!agentIdPattern.test(agentId))
267
+ return refusal(404, "No such agent");
268
+ const body = instructionsInputSchema.safeParse(await context.req.json());
269
+ if (!body.success)
270
+ return refusal(400, "Instructions are too long");
271
+ const result = await agents.setInstructions(agentId, body.data.instructions, principal);
272
+ if ("error" in result)
273
+ return refusal(result.error === "not_found" ? 404 : 403, result.error);
274
+ return Response.json(result);
233
275
  })
234
276
  .get("/agent-policies/:agentId", agent(), async (_context, { agentId }) => {
235
277
  if (!agentIdPattern.test(agentId))
@@ -23,7 +23,7 @@ import { type Release } from "@fungi.computer/puffball";
23
23
  import { type AppPublisherCoreConfigInput } from "./build/effect.js";
24
24
  import { type TeamAppCandidateManifest } from "./build/submission-contract.js";
25
25
  import { type ContentObjectOwner } from "./build/content-objects.js";
26
- import { type ArtifactHeads, type ArtifactStore } from "./release.js";
26
+ import { type ArtifactDeletes, type ArtifactHeads, type ArtifactStore } from "./release.js";
27
27
  import type { PublisherTemplateSeedReceipts } from "./source/seed-receipt.js";
28
28
  /** A Computer's whole-build budget: a cold build on a 6 GiB Computer measured 185-270 s. */
29
29
  export declare const oysterAppBuildTimeoutMs = 900000;
@@ -164,13 +164,15 @@ export type OysterAppBuildOptions = Readonly<{
164
164
  port: OysterBuildComputer;
165
165
  }>;
166
166
  /** The host's artifact store; a build's objects are already in it. */
167
- artifacts: ArtifactStore & ArtifactHeads;
167
+ artifacts: ArtifactStore & ArtifactHeads & ArtifactDeletes;
168
168
  /** The seed receipts a template build must match. */
169
169
  templates: Pick<PublisherTemplateSeedReceipts, "read">;
170
170
  now?: () => number;
171
171
  }>;
172
172
  /** Create the current build tables and index atomically; an older store is refused, never converted. */
173
173
  export declare function migrateOysterAppBuilds(owner: WatchdogSqliteOwner): void;
174
+ /** Build logs kept per App; older logs are removed after each new one is written. */
175
+ export declare const retainedBuildLogs = 5;
174
176
  /** The build owner over one tenant's SQLite, Computer and artifact store. */
175
177
  export declare function createOysterAppBuilds(options: OysterAppBuildOptions): Readonly<{
176
178
  /** Record (or replace) an App's build source; the caller is the owner. */
@@ -127,6 +127,7 @@ const jobRow = Schema.Struct({
127
127
  executable_until: Schema.Number,
128
128
  });
129
129
  const decodeJob = Schema.decodeUnknownSync(jobRow);
130
+ const decodeJobId = Schema.decodeUnknownSync(Schema.Struct({ job_id: Schema.String }));
130
131
  const sourceRow = Schema.Struct({ source: Schema.String });
131
132
  const releaseRow = Schema.Struct({ release: Schema.String });
132
133
  const sourceCodec = Schema.fromJsonString(oysterBuildSourceSchema);
@@ -169,6 +170,8 @@ export function migrateOysterAppBuilds(owner) {
169
170
  sql.exec("CREATE TABLE IF NOT EXISTS oyster_build_releases (release_id TEXT PRIMARY KEY, job_id TEXT NOT NULL UNIQUE, release TEXT NOT NULL) STRICT");
170
171
  });
171
172
  }
173
+ /** Build logs kept per App; older logs are removed after each new one is written. */
174
+ export const retainedBuildLogs = 5;
172
175
  /** The build owner over one tenant's SQLite, Computer and artifact store. */
173
176
  export function createOysterAppBuilds(options) {
174
177
  const { owner } = options;
@@ -245,6 +248,16 @@ export function createOysterAppBuilds(options) {
245
248
  // It is read only through the owner build door, never exposed as a Release.
246
249
  const logRef = (jobId) => parseArtifactRef(`artifact:build-log-${jobId}`);
247
250
  const logCodec = Schema.fromJsonString(buildJobLogSchema);
251
+ // Job rows and statuses stay; only the older logs of one App are removed.
252
+ // The ranking is read from the job table each time, so replays, retries and
253
+ // an owner restart can never delete a log inside the retained five.
254
+ const pruneLogs = async (appId) => {
255
+ const stale = owner.sql
256
+ .exec("SELECT job_id FROM oyster_build_jobs WHERE app_id=? ORDER BY issued_at DESC, rowid DESC LIMIT -1 OFFSET ?", appId, retainedBuildLogs)
257
+ .toArray();
258
+ for (const row of stale)
259
+ await options.artifacts.delete(logRef(decodeJobId(row).job_id));
260
+ };
248
261
  const publisher = createTeamBuildPublisher({
249
262
  teamId: options.tenantId,
250
263
  now,
@@ -286,6 +299,7 @@ export function createOysterAppBuilds(options) {
286
299
  timeoutMs: input.timeoutMs,
287
300
  });
288
301
  await options.artifacts.put(logRef(input.jobId), new TextEncoder().encode(Schema.encodeUnknownSync(logCodec)(result.log)));
302
+ await pruneLogs(required(input.jobId).app_id);
289
303
  if (result.output === null)
290
304
  throw new BuildOutcomeUnknown();
291
305
  return result;
@@ -68,6 +68,17 @@ export declare const permissionCatalog: {
68
68
  scope: "computer" | "agent" | null;
69
69
  warning: string | null;
70
70
  }>;
71
+ "agent.instructions": Readonly<{
72
+ group: "computers" | "agents" | "generation" | "bazaar" | "data" | "workflows" | "git" | "channels" | "apps" | "shell" | "other";
73
+ label: string;
74
+ caption: string;
75
+ description: string;
76
+ sigil: SigilName;
77
+ /** Presentation class only; invocation authority always comes from stored grants. */
78
+ consent: "affordance" | "install" | "ask";
79
+ scope: "computer" | "agent" | null;
80
+ warning: string | null;
81
+ }>;
71
82
  "agent.toolPolicy": Readonly<{
72
83
  group: "computers" | "agents" | "generation" | "bazaar" | "data" | "workflows" | "git" | "channels" | "apps" | "shell" | "other";
73
84
  label: string;
@@ -19,6 +19,7 @@ export const permissionCatalog = {
19
19
  "agent.manage": entry("agents", "Create and manage Agents", "create Agents and manage their sessions.", "createAgents", "install", "agent"),
20
20
  "agent.rename": entry("agents", "Rename Agents", "rename Agents you created.", "createAgents", "install"),
21
21
  "agent.avatar": entry("agents", "Change Agent avatars", "change the avatars of Agents you created.", "createAgents", "install"),
22
+ "agent.instructions": entry("agents", "Change Agent instructions", "change the standing instructions of your Agents.", "createAgents", "install"),
22
23
  "agent.toolPolicy": entry("agents", "Allow Agents to use Apps", "approve Agents to use your installed Apps.", "createAgents", "install"),
23
24
  "agent.read": entry("agents", "Read Agent conversations", "read Agent conversations.", "readConversations", "install", "agent"),
24
25
  "agent.send": entry("agents", "Send messages to Agents", "send messages to Agents.", "sendPrompts", "install", "agent"),
@@ -24,7 +24,7 @@ export declare const gateRequestSchema: z.ZodLazy<z.ZodDiscriminatedUnion<[z.Zod
24
24
  }, z.core.$strict>>>>;
25
25
  }, z.core.$strict>, z.ZodObject<{
26
26
  kind: z.ZodLiteral<"capability">;
27
- capability: z.ZodPipe<z.ZodUnknown, z.ZodTransform<"approvals" | "agent.list" | "agent.manage" | "agent.rename" | "agent.avatar" | "agent.toolPolicy" | "agent.read" | "agent.send" | "computer.list" | "computer.readFile" | "computer.writeFile" | "computer.execute" | "llm.generation" | "media.generation" | "media.share" | "games:servers" | "git.repository" | "apps.open" | "apps.call" | "app.storage" | "app.events.emit" | "team.workbenchHost" | "marketplace.browse" | "marketplace.purchase" | "workflow.run" | "workflow.publish" | "workflow.arm" | "world" | "channels.read" | "channels.personal.manage", unknown>>;
27
+ capability: z.ZodPipe<z.ZodUnknown, z.ZodTransform<"approvals" | "agent.list" | "agent.manage" | "agent.rename" | "agent.avatar" | "agent.instructions" | "agent.toolPolicy" | "agent.read" | "agent.send" | "computer.list" | "computer.readFile" | "computer.writeFile" | "computer.execute" | "llm.generation" | "media.generation" | "media.share" | "games:servers" | "git.repository" | "apps.open" | "apps.call" | "app.storage" | "app.events.emit" | "team.workbenchHost" | "marketplace.browse" | "marketplace.purchase" | "workflow.run" | "workflow.publish" | "workflow.arm" | "world" | "channels.read" | "channels.personal.manage", unknown>>;
28
28
  operation: z.ZodOptional<z.ZodString>;
29
29
  resource: z.ZodUnion<readonly [z.ZodLazy<z.ZodReadonly<z.ZodObject<{
30
30
  kind: z.ZodString;
@@ -32,7 +32,7 @@ export declare const gateRequestSchema: z.ZodLazy<z.ZodDiscriminatedUnion<[z.Zod
32
32
  }, z.core.$strict>>>, z.ZodLiteral<"any">]>;
33
33
  }, z.core.$strict>, z.ZodObject<{
34
34
  kind: z.ZodLiteral<"capability-route">;
35
- capability: z.ZodPipe<z.ZodUnknown, z.ZodTransform<"approvals" | "agent.list" | "agent.manage" | "agent.rename" | "agent.avatar" | "agent.toolPolicy" | "agent.read" | "agent.send" | "computer.list" | "computer.readFile" | "computer.writeFile" | "computer.execute" | "llm.generation" | "media.generation" | "media.share" | "games:servers" | "git.repository" | "apps.open" | "apps.call" | "app.storage" | "app.events.emit" | "team.workbenchHost" | "marketplace.browse" | "marketplace.purchase" | "workflow.run" | "workflow.publish" | "workflow.arm" | "world" | "channels.read" | "channels.personal.manage", unknown>>;
35
+ capability: z.ZodPipe<z.ZodUnknown, z.ZodTransform<"approvals" | "agent.list" | "agent.manage" | "agent.rename" | "agent.avatar" | "agent.instructions" | "agent.toolPolicy" | "agent.read" | "agent.send" | "computer.list" | "computer.readFile" | "computer.writeFile" | "computer.execute" | "llm.generation" | "media.generation" | "media.share" | "games:servers" | "git.repository" | "apps.open" | "apps.call" | "app.storage" | "app.events.emit" | "team.workbenchHost" | "marketplace.browse" | "marketplace.purchase" | "workflow.run" | "workflow.publish" | "workflow.arm" | "world" | "channels.read" | "channels.personal.manage", unknown>>;
36
36
  operation: z.ZodString;
37
37
  effect: z.ZodEnum<{
38
38
  read: "read";
@@ -28,7 +28,7 @@ export type ResourceRef = Exclude<ApprovedGrant["resources"], "tenant-scope">[nu
28
28
  * Exact operation rows are enforced for capability routes and backend bindings.
29
29
  */
30
30
  export declare const approvedGrantSchema: z.ZodReadonly<z.ZodObject<{
31
- capability: z.ZodPipe<z.ZodUnknown, z.ZodTransform<"approvals" | "agent.list" | "agent.manage" | "agent.rename" | "agent.avatar" | "agent.toolPolicy" | "agent.read" | "agent.send" | "computer.list" | "computer.readFile" | "computer.writeFile" | "computer.execute" | "llm.generation" | "media.generation" | "media.share" | "games:servers" | "git.repository" | "apps.open" | "apps.call" | "app.storage" | "app.events.emit" | "team.workbenchHost" | "marketplace.browse" | "marketplace.purchase" | "workflow.run" | "workflow.publish" | "workflow.arm" | "world" | "channels.read" | "channels.personal.manage", unknown>>;
31
+ capability: z.ZodPipe<z.ZodUnknown, z.ZodTransform<"approvals" | "agent.list" | "agent.manage" | "agent.rename" | "agent.avatar" | "agent.instructions" | "agent.toolPolicy" | "agent.read" | "agent.send" | "computer.list" | "computer.readFile" | "computer.writeFile" | "computer.execute" | "llm.generation" | "media.generation" | "media.share" | "games:servers" | "git.repository" | "apps.open" | "apps.call" | "app.storage" | "app.events.emit" | "team.workbenchHost" | "marketplace.browse" | "marketplace.purchase" | "workflow.run" | "workflow.publish" | "workflow.arm" | "world" | "channels.read" | "channels.personal.manage", unknown>>;
32
32
  capabilityApproved: z.ZodLiteral<true>;
33
33
  operations: z.ZodLazy<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
34
34
  resources: z.ZodUnion<readonly [z.ZodLiteral<"tenant-scope">, z.ZodReadonly<z.ZodArray<z.ZodLazy<z.ZodReadonly<z.ZodObject<{
@@ -39,7 +39,7 @@ export declare const approvedGrantSchema: z.ZodReadonly<z.ZodObject<{
39
39
  export type ApprovedGrant = Readonly<z.output<typeof approvedGrantSchema>>;
40
40
  /** A bounded owner edit. Unnamed approvals are not part of the command. */
41
41
  export declare const grantChangeSchema: z.ZodReadonly<z.ZodObject<{
42
- capability: z.ZodPipe<z.ZodUnknown, z.ZodTransform<"approvals" | "agent.list" | "agent.manage" | "agent.rename" | "agent.avatar" | "agent.toolPolicy" | "agent.read" | "agent.send" | "computer.list" | "computer.readFile" | "computer.writeFile" | "computer.execute" | "llm.generation" | "media.generation" | "media.share" | "games:servers" | "git.repository" | "apps.open" | "apps.call" | "app.storage" | "app.events.emit" | "team.workbenchHost" | "marketplace.browse" | "marketplace.purchase" | "workflow.run" | "workflow.publish" | "workflow.arm" | "world" | "channels.read" | "channels.personal.manage", unknown>>;
42
+ capability: z.ZodPipe<z.ZodUnknown, z.ZodTransform<"approvals" | "agent.list" | "agent.manage" | "agent.rename" | "agent.avatar" | "agent.instructions" | "agent.toolPolicy" | "agent.read" | "agent.send" | "computer.list" | "computer.readFile" | "computer.writeFile" | "computer.execute" | "llm.generation" | "media.generation" | "media.share" | "games:servers" | "git.repository" | "apps.open" | "apps.call" | "app.storage" | "app.events.emit" | "team.workbenchHost" | "marketplace.browse" | "marketplace.purchase" | "workflow.run" | "workflow.publish" | "workflow.arm" | "world" | "channels.read" | "channels.personal.manage", unknown>>;
43
43
  grant: z.ZodNullable<z.ZodReadonly<z.ZodObject<{
44
44
  operations: z.ZodLazy<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
45
45
  resources: z.ZodUnion<readonly [z.ZodLiteral<"tenant-scope">, z.ZodReadonly<z.ZodArray<z.ZodLazy<z.ZodReadonly<z.ZodObject<{
@@ -60,7 +60,7 @@ export declare const appAuthoritySchema: z.ZodObject<{
60
60
  authorityVersion: z.ZodLazy<z.ZodNumber>;
61
61
  declaredOperationsDigest: z.ZodPipe<z.ZodUnknown, z.ZodTransform<import("@fungi.computer/puffball").Sha256Digest, unknown>>;
62
62
  approvedGrants: z.ZodLazy<z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
63
- capability: z.ZodPipe<z.ZodUnknown, z.ZodTransform<"approvals" | "agent.list" | "agent.manage" | "agent.rename" | "agent.avatar" | "agent.toolPolicy" | "agent.read" | "agent.send" | "computer.list" | "computer.readFile" | "computer.writeFile" | "computer.execute" | "llm.generation" | "media.generation" | "media.share" | "games:servers" | "git.repository" | "apps.open" | "apps.call" | "app.storage" | "app.events.emit" | "team.workbenchHost" | "marketplace.browse" | "marketplace.purchase" | "workflow.run" | "workflow.publish" | "workflow.arm" | "world" | "channels.read" | "channels.personal.manage", unknown>>;
63
+ capability: z.ZodPipe<z.ZodUnknown, z.ZodTransform<"approvals" | "agent.list" | "agent.manage" | "agent.rename" | "agent.avatar" | "agent.instructions" | "agent.toolPolicy" | "agent.read" | "agent.send" | "computer.list" | "computer.readFile" | "computer.writeFile" | "computer.execute" | "llm.generation" | "media.generation" | "media.share" | "games:servers" | "git.repository" | "apps.open" | "apps.call" | "app.storage" | "app.events.emit" | "team.workbenchHost" | "marketplace.browse" | "marketplace.purchase" | "workflow.run" | "workflow.publish" | "workflow.arm" | "world" | "channels.read" | "channels.personal.manage", unknown>>;
64
64
  capabilityApproved: z.ZodLiteral<true>;
65
65
  operations: z.ZodLazy<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
66
66
  resources: z.ZodUnion<readonly [z.ZodLiteral<"tenant-scope">, z.ZodReadonly<z.ZodArray<z.ZodLazy<z.ZodReadonly<z.ZodObject<{
@@ -89,7 +89,7 @@ export declare const grantCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
89
89
  }, z.core.$strict>, z.ZodObject<{
90
90
  kind: z.ZodLiteral<"change-grants">;
91
91
  changes: z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
92
- capability: z.ZodPipe<z.ZodUnknown, z.ZodTransform<"approvals" | "agent.list" | "agent.manage" | "agent.rename" | "agent.avatar" | "agent.toolPolicy" | "agent.read" | "agent.send" | "computer.list" | "computer.readFile" | "computer.writeFile" | "computer.execute" | "llm.generation" | "media.generation" | "media.share" | "games:servers" | "git.repository" | "apps.open" | "apps.call" | "app.storage" | "app.events.emit" | "team.workbenchHost" | "marketplace.browse" | "marketplace.purchase" | "workflow.run" | "workflow.publish" | "workflow.arm" | "world" | "channels.read" | "channels.personal.manage", unknown>>;
92
+ capability: z.ZodPipe<z.ZodUnknown, z.ZodTransform<"approvals" | "agent.list" | "agent.manage" | "agent.rename" | "agent.avatar" | "agent.instructions" | "agent.toolPolicy" | "agent.read" | "agent.send" | "computer.list" | "computer.readFile" | "computer.writeFile" | "computer.execute" | "llm.generation" | "media.generation" | "media.share" | "games:servers" | "git.repository" | "apps.open" | "apps.call" | "app.storage" | "app.events.emit" | "team.workbenchHost" | "marketplace.browse" | "marketplace.purchase" | "workflow.run" | "workflow.publish" | "workflow.arm" | "world" | "channels.read" | "channels.personal.manage", unknown>>;
93
93
  grant: z.ZodNullable<z.ZodReadonly<z.ZodObject<{
94
94
  operations: z.ZodLazy<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
95
95
  resources: z.ZodUnion<readonly [z.ZodLiteral<"tenant-scope">, z.ZodReadonly<z.ZodArray<z.ZodLazy<z.ZodReadonly<z.ZodObject<{
@@ -124,7 +124,7 @@ export declare const declaredOperationsSchema: z.ZodLazy<z.ZodObject<{
124
124
  artifactDigest: z.ZodPipe<z.ZodUnknown, z.ZodTransform<import("@fungi.computer/puffball").Sha256Digest, unknown>>;
125
125
  digest: z.ZodPipe<z.ZodUnknown, z.ZodTransform<import("@fungi.computer/puffball").Sha256Digest, unknown>>;
126
126
  capabilities: z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
127
- capability: z.ZodPipe<z.ZodUnknown, z.ZodTransform<"approvals" | "agent.list" | "agent.manage" | "agent.rename" | "agent.avatar" | "agent.toolPolicy" | "agent.read" | "agent.send" | "computer.list" | "computer.readFile" | "computer.writeFile" | "computer.execute" | "llm.generation" | "media.generation" | "media.share" | "games:servers" | "git.repository" | "apps.open" | "apps.call" | "app.storage" | "app.events.emit" | "team.workbenchHost" | "marketplace.browse" | "marketplace.purchase" | "workflow.run" | "workflow.publish" | "workflow.arm" | "world" | "channels.read" | "channels.personal.manage", unknown>>;
127
+ capability: z.ZodPipe<z.ZodUnknown, z.ZodTransform<"approvals" | "agent.list" | "agent.manage" | "agent.rename" | "agent.avatar" | "agent.instructions" | "agent.toolPolicy" | "agent.read" | "agent.send" | "computer.list" | "computer.readFile" | "computer.writeFile" | "computer.execute" | "llm.generation" | "media.generation" | "media.share" | "games:servers" | "git.repository" | "apps.open" | "apps.call" | "app.storage" | "app.events.emit" | "team.workbenchHost" | "marketplace.browse" | "marketplace.purchase" | "workflow.run" | "workflow.publish" | "workflow.arm" | "world" | "channels.read" | "channels.personal.manage", unknown>>;
128
128
  operations: z.ZodLazy<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
129
129
  }, z.core.$strict>>>>;
130
130
  }, z.core.$strict>>;
@@ -159,7 +159,7 @@ export declare const installationSchema: z.ZodObject<{
159
159
  authorityVersion: z.ZodLazy<z.ZodNumber>;
160
160
  declaredOperationsDigest: z.ZodPipe<z.ZodUnknown, z.ZodTransform<import("@fungi.computer/puffball").Sha256Digest, unknown>>;
161
161
  approvedGrants: z.ZodLazy<z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
162
- capability: z.ZodPipe<z.ZodUnknown, z.ZodTransform<"approvals" | "agent.list" | "agent.manage" | "agent.rename" | "agent.avatar" | "agent.toolPolicy" | "agent.read" | "agent.send" | "computer.list" | "computer.readFile" | "computer.writeFile" | "computer.execute" | "llm.generation" | "media.generation" | "media.share" | "games:servers" | "git.repository" | "apps.open" | "apps.call" | "app.storage" | "app.events.emit" | "team.workbenchHost" | "marketplace.browse" | "marketplace.purchase" | "workflow.run" | "workflow.publish" | "workflow.arm" | "world" | "channels.read" | "channels.personal.manage", unknown>>;
162
+ capability: z.ZodPipe<z.ZodUnknown, z.ZodTransform<"approvals" | "agent.list" | "agent.manage" | "agent.rename" | "agent.avatar" | "agent.instructions" | "agent.toolPolicy" | "agent.read" | "agent.send" | "computer.list" | "computer.readFile" | "computer.writeFile" | "computer.execute" | "llm.generation" | "media.generation" | "media.share" | "games:servers" | "git.repository" | "apps.open" | "apps.call" | "app.storage" | "app.events.emit" | "team.workbenchHost" | "marketplace.browse" | "marketplace.purchase" | "workflow.run" | "workflow.publish" | "workflow.arm" | "world" | "channels.read" | "channels.personal.manage", unknown>>;
163
163
  capabilityApproved: z.ZodLiteral<true>;
164
164
  operations: z.ZodLazy<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
165
165
  resources: z.ZodUnion<readonly [z.ZodLiteral<"tenant-scope">, z.ZodReadonly<z.ZodArray<z.ZodLazy<z.ZodReadonly<z.ZodObject<{
@@ -238,7 +238,7 @@ export declare const installationCommandSchema: z.ZodLazy<z.ZodDiscriminatedUnio
238
238
  }, z.core.$strict>, z.ZodObject<{
239
239
  kind: z.ZodLiteral<"change-grants">;
240
240
  changes: z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
241
- capability: z.ZodPipe<z.ZodUnknown, z.ZodTransform<"approvals" | "agent.list" | "agent.manage" | "agent.rename" | "agent.avatar" | "agent.toolPolicy" | "agent.read" | "agent.send" | "computer.list" | "computer.readFile" | "computer.writeFile" | "computer.execute" | "llm.generation" | "media.generation" | "media.share" | "games:servers" | "git.repository" | "apps.open" | "apps.call" | "app.storage" | "app.events.emit" | "team.workbenchHost" | "marketplace.browse" | "marketplace.purchase" | "workflow.run" | "workflow.publish" | "workflow.arm" | "world" | "channels.read" | "channels.personal.manage", unknown>>;
241
+ capability: z.ZodPipe<z.ZodUnknown, z.ZodTransform<"approvals" | "agent.list" | "agent.manage" | "agent.rename" | "agent.avatar" | "agent.instructions" | "agent.toolPolicy" | "agent.read" | "agent.send" | "computer.list" | "computer.readFile" | "computer.writeFile" | "computer.execute" | "llm.generation" | "media.generation" | "media.share" | "games:servers" | "git.repository" | "apps.open" | "apps.call" | "app.storage" | "app.events.emit" | "team.workbenchHost" | "marketplace.browse" | "marketplace.purchase" | "workflow.run" | "workflow.publish" | "workflow.arm" | "world" | "channels.read" | "channels.personal.manage", unknown>>;
242
242
  grant: z.ZodNullable<z.ZodReadonly<z.ZodObject<{
243
243
  operations: z.ZodLazy<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
244
244
  resources: z.ZodUnion<readonly [z.ZodLiteral<"tenant-scope">, z.ZodReadonly<z.ZodArray<z.ZodLazy<z.ZodReadonly<z.ZodObject<{
@@ -77,7 +77,7 @@ export declare const appPermissionsWireSchema: z.ZodObject<{
77
77
  authorityVersion: z.ZodLazy<z.ZodNumber>;
78
78
  declaredOperationsDigest: z.ZodPipe<z.ZodUnknown, z.ZodTransform<import("@fungi.computer/puffball").Sha256Digest, unknown>>;
79
79
  approvedGrants: z.ZodLazy<z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
80
- capability: z.ZodPipe<z.ZodUnknown, z.ZodTransform<"approvals" | "agent.list" | "agent.manage" | "agent.rename" | "agent.avatar" | "agent.toolPolicy" | "agent.read" | "agent.send" | "computer.list" | "computer.readFile" | "computer.writeFile" | "computer.execute" | "llm.generation" | "media.generation" | "media.share" | "games:servers" | "git.repository" | "apps.open" | "apps.call" | "app.storage" | "app.events.emit" | "team.workbenchHost" | "marketplace.browse" | "marketplace.purchase" | "workflow.run" | "workflow.publish" | "workflow.arm" | "world" | "channels.read" | "channels.personal.manage", unknown>>;
80
+ capability: z.ZodPipe<z.ZodUnknown, z.ZodTransform<"approvals" | "agent.list" | "agent.manage" | "agent.rename" | "agent.avatar" | "agent.instructions" | "agent.toolPolicy" | "agent.read" | "agent.send" | "computer.list" | "computer.readFile" | "computer.writeFile" | "computer.execute" | "llm.generation" | "media.generation" | "media.share" | "games:servers" | "git.repository" | "apps.open" | "apps.call" | "app.storage" | "app.events.emit" | "team.workbenchHost" | "marketplace.browse" | "marketplace.purchase" | "workflow.run" | "workflow.publish" | "workflow.arm" | "world" | "channels.read" | "channels.personal.manage", unknown>>;
81
81
  capabilityApproved: z.ZodLiteral<true>;
82
82
  operations: z.ZodLazy<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
83
83
  resources: z.ZodUnion<readonly [z.ZodLiteral<"tenant-scope">, z.ZodReadonly<z.ZodArray<z.ZodLazy<z.ZodReadonly<z.ZodObject<{
@@ -104,7 +104,7 @@ export declare const appPermissionsWireSchema: z.ZodObject<{
104
104
  artifactDigest: z.ZodPipe<z.ZodUnknown, z.ZodTransform<import("@fungi.computer/puffball").Sha256Digest, unknown>>;
105
105
  digest: z.ZodPipe<z.ZodUnknown, z.ZodTransform<import("@fungi.computer/puffball").Sha256Digest, unknown>>;
106
106
  capabilities: z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
107
- capability: z.ZodPipe<z.ZodUnknown, z.ZodTransform<"approvals" | "agent.list" | "agent.manage" | "agent.rename" | "agent.avatar" | "agent.toolPolicy" | "agent.read" | "agent.send" | "computer.list" | "computer.readFile" | "computer.writeFile" | "computer.execute" | "llm.generation" | "media.generation" | "media.share" | "games:servers" | "git.repository" | "apps.open" | "apps.call" | "app.storage" | "app.events.emit" | "team.workbenchHost" | "marketplace.browse" | "marketplace.purchase" | "workflow.run" | "workflow.publish" | "workflow.arm" | "world" | "channels.read" | "channels.personal.manage", unknown>>;
107
+ capability: z.ZodPipe<z.ZodUnknown, z.ZodTransform<"approvals" | "agent.list" | "agent.manage" | "agent.rename" | "agent.avatar" | "agent.instructions" | "agent.toolPolicy" | "agent.read" | "agent.send" | "computer.list" | "computer.readFile" | "computer.writeFile" | "computer.execute" | "llm.generation" | "media.generation" | "media.share" | "games:servers" | "git.repository" | "apps.open" | "apps.call" | "app.storage" | "app.events.emit" | "team.workbenchHost" | "marketplace.browse" | "marketplace.purchase" | "workflow.run" | "workflow.publish" | "workflow.arm" | "world" | "channels.read" | "channels.personal.manage", unknown>>;
108
108
  operations: z.ZodLazy<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
109
109
  }, z.core.$strict>>>>;
110
110
  }, z.core.$strict>>;
@@ -177,7 +177,7 @@ export declare const permissionSaveSchema: z.ZodObject<{
177
177
  }, z.core.$strict>, z.ZodObject<{
178
178
  kind: z.ZodLiteral<"change-grants">;
179
179
  changes: z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
180
- capability: z.ZodPipe<z.ZodUnknown, z.ZodTransform<"approvals" | "agent.list" | "agent.manage" | "agent.rename" | "agent.avatar" | "agent.toolPolicy" | "agent.read" | "agent.send" | "computer.list" | "computer.readFile" | "computer.writeFile" | "computer.execute" | "llm.generation" | "media.generation" | "media.share" | "games:servers" | "git.repository" | "apps.open" | "apps.call" | "app.storage" | "app.events.emit" | "team.workbenchHost" | "marketplace.browse" | "marketplace.purchase" | "workflow.run" | "workflow.publish" | "workflow.arm" | "world" | "channels.read" | "channels.personal.manage", unknown>>;
180
+ capability: z.ZodPipe<z.ZodUnknown, z.ZodTransform<"approvals" | "agent.list" | "agent.manage" | "agent.rename" | "agent.avatar" | "agent.instructions" | "agent.toolPolicy" | "agent.read" | "agent.send" | "computer.list" | "computer.readFile" | "computer.writeFile" | "computer.execute" | "llm.generation" | "media.generation" | "media.share" | "games:servers" | "git.repository" | "apps.open" | "apps.call" | "app.storage" | "app.events.emit" | "team.workbenchHost" | "marketplace.browse" | "marketplace.purchase" | "workflow.run" | "workflow.publish" | "workflow.arm" | "world" | "channels.read" | "channels.personal.manage", unknown>>;
181
181
  grant: z.ZodNullable<z.ZodReadonly<z.ZodObject<{
182
182
  operations: z.ZodLazy<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
183
183
  resources: z.ZodUnion<readonly [z.ZodLiteral<"tenant-scope">, z.ZodReadonly<z.ZodArray<z.ZodLazy<z.ZodReadonly<z.ZodObject<{
@@ -225,7 +225,7 @@ export declare const appPermissionPageSchema: z.ZodObject<{
225
225
  authorityVersion: z.ZodLazy<z.ZodNumber>;
226
226
  declaredOperationsDigest: z.ZodPipe<z.ZodUnknown, z.ZodTransform<import("@fungi.computer/puffball").Sha256Digest, unknown>>;
227
227
  approvedGrants: z.ZodLazy<z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
228
- capability: z.ZodPipe<z.ZodUnknown, z.ZodTransform<"approvals" | "agent.list" | "agent.manage" | "agent.rename" | "agent.avatar" | "agent.toolPolicy" | "agent.read" | "agent.send" | "computer.list" | "computer.readFile" | "computer.writeFile" | "computer.execute" | "llm.generation" | "media.generation" | "media.share" | "games:servers" | "git.repository" | "apps.open" | "apps.call" | "app.storage" | "app.events.emit" | "team.workbenchHost" | "marketplace.browse" | "marketplace.purchase" | "workflow.run" | "workflow.publish" | "workflow.arm" | "world" | "channels.read" | "channels.personal.manage", unknown>>;
228
+ capability: z.ZodPipe<z.ZodUnknown, z.ZodTransform<"approvals" | "agent.list" | "agent.manage" | "agent.rename" | "agent.avatar" | "agent.instructions" | "agent.toolPolicy" | "agent.read" | "agent.send" | "computer.list" | "computer.readFile" | "computer.writeFile" | "computer.execute" | "llm.generation" | "media.generation" | "media.share" | "games:servers" | "git.repository" | "apps.open" | "apps.call" | "app.storage" | "app.events.emit" | "team.workbenchHost" | "marketplace.browse" | "marketplace.purchase" | "workflow.run" | "workflow.publish" | "workflow.arm" | "world" | "channels.read" | "channels.personal.manage", unknown>>;
229
229
  capabilityApproved: z.ZodLiteral<true>;
230
230
  operations: z.ZodLazy<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
231
231
  resources: z.ZodUnion<readonly [z.ZodLiteral<"tenant-scope">, z.ZodReadonly<z.ZodArray<z.ZodLazy<z.ZodReadonly<z.ZodObject<{
@@ -252,7 +252,7 @@ export declare const appPermissionPageSchema: z.ZodObject<{
252
252
  artifactDigest: z.ZodPipe<z.ZodUnknown, z.ZodTransform<import("@fungi.computer/puffball").Sha256Digest, unknown>>;
253
253
  digest: z.ZodPipe<z.ZodUnknown, z.ZodTransform<import("@fungi.computer/puffball").Sha256Digest, unknown>>;
254
254
  capabilities: z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
255
- capability: z.ZodPipe<z.ZodUnknown, z.ZodTransform<"approvals" | "agent.list" | "agent.manage" | "agent.rename" | "agent.avatar" | "agent.toolPolicy" | "agent.read" | "agent.send" | "computer.list" | "computer.readFile" | "computer.writeFile" | "computer.execute" | "llm.generation" | "media.generation" | "media.share" | "games:servers" | "git.repository" | "apps.open" | "apps.call" | "app.storage" | "app.events.emit" | "team.workbenchHost" | "marketplace.browse" | "marketplace.purchase" | "workflow.run" | "workflow.publish" | "workflow.arm" | "world" | "channels.read" | "channels.personal.manage", unknown>>;
255
+ capability: z.ZodPipe<z.ZodUnknown, z.ZodTransform<"approvals" | "agent.list" | "agent.manage" | "agent.rename" | "agent.avatar" | "agent.instructions" | "agent.toolPolicy" | "agent.read" | "agent.send" | "computer.list" | "computer.readFile" | "computer.writeFile" | "computer.execute" | "llm.generation" | "media.generation" | "media.share" | "games:servers" | "git.repository" | "apps.open" | "apps.call" | "app.storage" | "app.events.emit" | "team.workbenchHost" | "marketplace.browse" | "marketplace.purchase" | "workflow.run" | "workflow.publish" | "workflow.arm" | "world" | "channels.read" | "channels.personal.manage", unknown>>;
256
256
  operations: z.ZodLazy<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
257
257
  }, z.core.$strict>>>>;
258
258
  }, z.core.$strict>>;