roster/conversation-agents

Import

Import

import * as api from "@fungi.computer/shiitake-extensions/roster/conversation-agents";

Exports

Kind	Export	Description
fnfunction	assertOrdinaryAgentCreation()	Host-pack creation admission; attachments/model selection retain their own owners.
fnfunction	createConversationAgents()	This host’s own record of the Agents each conversation created or sent accepted work to, written as its Agent-control directory accepts them (Wiki: agent-runtime-tools-and-clients, read-only sub-agent view). Accepted child command receipts are separately reconciled against their owner’s settlement records for the parent’s goal guard. Neither record grants authority over a child.
fnfunction	oysterAgentExtensions()	Both hosts compose the ordinary roster and its read-only created-Agent footer.

assertOrdinaryAgentCreation()fnfunction

Signature

function assertOrdinaryAgentCreation(input): void;

Host-pack creation admission; attachments/model selection retain their own owners.

Parameters

Parameter	Type
input	Readonly<{ requestId: string; name?: string; model?: { providerId: string; modelId: string; reasoning?: "minimal" | "low" | "medium" | "high" | "xhigh" | "max"; }; extensions?: readonly string[]; }>

Returns

void

---

createConversationAgents()fnfunction

Signature

function createConversationAgents(storage): object;

This host’s own record of the Agents each conversation created or sent accepted work to, written as its Agent-control directory accepts them (Wiki: agent-runtime-tools-and-clients, read-only sub-agent view). Accepted child command receipts are separately reconciled against their owner’s settlement records for the parent’s goal guard. Neither record grants authority over a child.

Parameters

Parameter	Type
storage	WatchdogSqliteOwner

Returns

Name	Type	Description
recording()	(parentSessionId, directory) => AgentControlDirectory	Bind acceptance recording to this conversation’s existing directory. One conversation’s directory: its accepted creates and sends are recorded.
control()	(directoryFor) => CapabilitySource	Agent-control tools bound to the conversation that acquires them.
source()	(directory) => SubagentSource	The footer rows for one conversation; archived and unknown Agents leave it.

---

oysterAgentExtensions()fnfunction

Signature

function oysterAgentExtensions(source): Readonly<{
  roster: readonly RosteredExtensionV0[];
  grants: readonly Readonly<{
    id: string & Brand<"ExtensionId">;
    capabilities: readonly ExtensionCapabilityV0[];
    grantKey?: string;
  }>[];
}>;

Both hosts compose the ordinary roster and its read-only created-Agent footer.

Parameters

Parameter	Type
source	SubagentSource

Returns

Readonly<{ roster: readonly RosteredExtensionV0[]; grants: readonly Readonly<{ id: string & Brand<"ExtensionId">; capabilities: readonly ExtensionCapabilityV0[]; grantKey?: string; }>[]; }>