subagents/host

Import

Import

import * as api from "@fungi.computer/shiitake-extensions/subagents/host";

Exports

Kind	Export	Description
Ttype alias	SubagentRecord	A footer row for an ordinary Agent created by the current Agent.
Ttype alias	SubagentAgent	Owner reads used for status and exact delegated command settlement.
Ttype alias	SubagentSource	The host’s read-only facts. read returns ordinary created Agents, at most limit, with a count of the rest; open is the host’s existing per-operation Agent access (an AgentControlDirectory’s open fits), and releasing it never stops the Agent’s work.
Ttype alias	SubagentTiming	Private resource ceilings; none of them is product policy.
constconstant	subagentsGrant	Host admission for the read-only created-Agent footer and human toggle.
fnfunction	subagentsExtension()	The read-only footer: ordinary Agents created by this Agent, one row each, with their live status. It owns neither relationships nor durable state; the Agent directory owns immutable creation attribution. Its one command, /agents, only expands or collapses the footer rows.

SubagentRecordTtype alias

Signature

type SubagentRecord = Readonly<{
  agentId: string;
  name: string;
  sessionId: string | null;
}>;

A footer row for an ordinary Agent created by the current Agent.

---

SubagentAgentTtype alias

Signature

type SubagentAgent = Readonly<{
  listSessions: ShiitakeAgent["listSessions"];
  session: (
    sessionId,
  ) => Pick<ShiitakeSession, "read" | "readSettlement" | "extension">;
}>;

Owner reads used for status and exact delegated command settlement.

---

SubagentSourceTtype alias

Signature

type SubagentSource = Readonly<{
  hasLiveChildCommand: (sessionId) => boolean;
  read: (
    sessionId,
    limit,
  ) => Promise<
    Readonly<{
      agents: readonly SubagentRecord[];
      more: number;
    }>
  >;
  open: (
    agentId,
    signal,
  ) => Promise<
    Readonly<{
      agent: SubagentAgent;
      release: () => Promise<void>;
    }>
  >;
}>;

The host’s read-only facts. read returns ordinary created Agents, at most limit, with a count of the rest; open is the host’s existing per-operation Agent access (an AgentControlDirectory’s open fits), and releasing it never stops the Agent’s work.

---

SubagentTimingTtype alias

Signature

type SubagentTiming = Readonly<{
  refreshMs: number;
  pollMs: number;
  interestMs: number;
}>;

Private resource ceilings; none of them is product policy.

subagentsGrantconstconstant

Signature

const subagentsGrant: ExtensionGrantV0;

Host admission for the read-only created-Agent footer and human toggle.

subagentsExtension()fnfunction

Signature

function subagentsExtension(options): RosteredExtensionV0;

The read-only footer: ordinary Agents created by this Agent, one row each, with their live status. It owns neither relationships nor durable state; the Agent directory owns immutable creation attribution. Its one command, /agents, only expands or collapses the footer rows.

Parameters

Parameter	Type
options	Readonly<{ source: SubagentSource; timing?: SubagentTiming; }>

Returns

RosteredExtensionV0