@datalayer/agent-runtimes 1.0.28 → 1.3.10

package/lib/loop/plugins/agent-compaction/index.d.ts

@@ -0,0 +1,10 @@
+export declare const AGENT_COMPACTION_PLUGIN_NAME = "@datalayer/loop-plugin-agent-compaction";
+/** The budget the plain plugin mounts the agent under, in tokens. */
+export declare const DEFAULT_COMPACTION_MAX_TOKENS = 8000;
+/**
+ * The capacity for a given budget: what a page that lets the person pick the
+ * budget builds once the choice is made.
+ */
+export declare function createAgentCompactionPlugin(maxTokens: number): import("@datalayer/reactor").ReactorPlugin<Record<string, never>, unknown, unknown>;
+export declare const AgentCompactionPlugin: import("@datalayer/reactor").ReactorPlugin<Record<string, never>, unknown, unknown>;
+export default AgentCompactionPlugin;

package/lib/loop/plugins/agent-compaction/index.js

@@ -0,0 +1,34 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * `@datalayer/loop-plugin-agent-compaction` — history compaction, as a capacity.
+ *
+ * Mounts the `example-compaction` agent, a long-winded one, under a context
+ * token budget: once the history grows past it, older turns are summarized.
+ * Cast from the shared capacity mould; the openers are the spec's own.
+ *
+ * @module loop/plugins/agent-compaction
+ */
+import { defineAgentCapacityPlugin } from '../agent-capacity';
+export const AGENT_COMPACTION_PLUGIN_NAME = '@datalayer/loop-plugin-agent-compaction';
+/** The budget the plain plugin mounts the agent under, in tokens. */
+export const DEFAULT_COMPACTION_MAX_TOKENS = 8000;
+/**
+ * The capacity for a given budget: what a page that lets the person pick the
+ * budget builds once the choice is made.
+ */
+export function createAgentCompactionPlugin(maxTokens) {
+    return defineAgentCapacityPlugin({
+        key: 'compaction',
+        displayName: 'Agent Compaction',
+        description: `History compaction under a ${maxTokens.toLocaleString()} token budget.`,
+        specId: 'example-compaction',
+        octicon: 'history',
+        emoji: '🗜️',
+        createPayload: { compactionMaxTokens: maxTokens },
+    });
+}
+export const AgentCompactionPlugin = createAgentCompactionPlugin(DEFAULT_COMPACTION_MAX_TOKENS);
+export default AgentCompactionPlugin;

package/lib/loop/plugins/agent-evals/index.d.ts

@@ -0,0 +1,3 @@
+export declare const AGENT_EVALS_PLUGIN_NAME = "@datalayer/loop-plugin-agent-evals";
+export declare const AgentEvalsPlugin: import("@datalayer/reactor").ReactorPlugin<Record<string, never>, unknown, unknown>;
+export default AgentEvalsPlugin;

package/lib/loop/plugins/agent-evals/index.js

@@ -0,0 +1,25 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * `@datalayer/loop-plugin-agent-evals` — the capacity, as a plugin.
+ *
+ * Mounts the `example-evals` agent and offers what it is worth asking. Cast
+ * from the shared capacity mould; see `loop/plugins/agent-capacity`.
+ *
+ * The openers are the spec's own.
+ *
+ * @module loop/plugins/agent-evals
+ */
+import { defineAgentCapacityPlugin } from '../agent-capacity';
+export const AGENT_EVALS_PLUGIN_NAME = '@datalayer/loop-plugin-agent-evals';
+export const AgentEvalsPlugin = defineAgentCapacityPlugin({
+    key: 'evals',
+    displayName: 'Agent Evals',
+    description: 'Agent Evals',
+    specId: 'example-evals',
+    octicon: 'beaker',
+    emoji: '🧪',
+});
+export default AgentEvalsPlugin;

package/lib/loop/plugins/agent-guardrails/index.d.ts

@@ -0,0 +1,3 @@
+export declare const AGENT_GUARDRAILS_PLUGIN_NAME = "@datalayer/loop-plugin-agent-guardrails";
+export declare const AgentGuardrailsPlugin: import("@datalayer/reactor").ReactorPlugin<Record<string, never>, unknown, unknown>;
+export default AgentGuardrailsPlugin;

package/lib/loop/plugins/agent-guardrails/index.js

@@ -0,0 +1,25 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * `@datalayer/loop-plugin-agent-guardrails` — the capacity, as a plugin.
+ *
+ * Mounts the `example-guardrails` agent and offers what it is worth asking. Cast
+ * from the shared capacity mould; see `loop/plugins/agent-capacity`.
+ *
+ * The openers are the spec's own.
+ *
+ * @module loop/plugins/agent-guardrails
+ */
+import { defineAgentCapacityPlugin } from '../agent-capacity';
+export const AGENT_GUARDRAILS_PLUGIN_NAME = '@datalayer/loop-plugin-agent-guardrails';
+export const AgentGuardrailsPlugin = defineAgentCapacityPlugin({
+    key: 'guardrails',
+    displayName: 'Agent Guardrails',
+    description: 'Cost guardrail with OTEL-backed gauge and hook-aware approvals (before_tool_execute, after_tool_execute, on_tool_execute_error, deferred_tool_calls)',
+    specId: 'example-guardrails',
+    octicon: 'shield-lock',
+    emoji: '🚧',
+});
+export default AgentGuardrailsPlugin;

package/lib/loop/plugins/agent-hooks/index.d.ts

@@ -0,0 +1,3 @@
+export declare const AGENT_HOOKS_PLUGIN_NAME = "@datalayer/loop-plugin-agent-hooks";
+export declare const AgentHooksPlugin: import("@datalayer/reactor").ReactorPlugin<Record<string, never>, unknown, unknown>;
+export default AgentHooksPlugin;

package/lib/loop/plugins/agent-hooks/index.js

@@ -0,0 +1,28 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * `@datalayer/loop-plugin-agent-hooks` — lifecycle hooks, as a capacity.
+ *
+ * Mounts the `example-hooks` agent: pre-hooks that ran before the loop (a
+ * marker file, injected variables, a pip install), pydantic-style tool hooks
+ * around every call (`before_tool_execute`, `after_tool_execute`,
+ * `on_tool_execute_error`), and deferred tool calls for approval-gated
+ * tools.
+ *
+ * The openers are the spec's own.
+ *
+ * @module loop/plugins/agent-hooks
+ */
+import { defineAgentCapacityPlugin } from '../agent-capacity';
+export const AGENT_HOOKS_PLUGIN_NAME = '@datalayer/loop-plugin-agent-hooks';
+export const AgentHooksPlugin = defineAgentCapacityPlugin({
+    key: 'hooks',
+    displayName: 'Agent Hooks',
+    description: 'Lifecycle hooks and pydantic-style tool hooks: before_tool_execute, after_tool_execute, on_tool_execute_error, deferred_tool_calls.',
+    specId: 'example-hooks',
+    octicon: 'sync',
+    emoji: '\u{1F501}',
+});
+export default AgentHooksPlugin;

package/lib/loop/plugins/agent-inference/index.d.ts

@@ -0,0 +1,7 @@
+export declare const AGENT_INFERENCE_PLUGIN_NAME = "@datalayer/loop-plugin-agent-inference";
+/** Where the agent's model calls go. */
+export type InferenceProviderKind = 'local' | 'datalayer';
+/** The capacity for one provider: what a page that switches providers builds per choice. */
+export declare function createAgentInferencePlugin(provider: InferenceProviderKind): import("@datalayer/reactor").ReactorPlugin<Record<string, never>, unknown, unknown>;
+export declare const AgentInferencePlugin: import("@datalayer/reactor").ReactorPlugin<Record<string, never>, unknown, unknown>;
+export default AgentInferencePlugin;

package/lib/loop/plugins/agent-inference/index.js

@@ -0,0 +1,29 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * `@datalayer/loop-plugin-agent-inference` — the inference provider, as a capacity.
+ *
+ * Mounts the `example-inference` agent on a given inference provider — the
+ * server's own model access, or Datalayer's inference service. Cast from the
+ * shared capacity mould; the openers are the spec's own.
+ *
+ * @module loop/plugins/agent-inference
+ */
+import { defineAgentCapacityPlugin } from '../agent-capacity';
+export const AGENT_INFERENCE_PLUGIN_NAME = '@datalayer/loop-plugin-agent-inference';
+/** The capacity for one provider: what a page that switches providers builds per choice. */
+export function createAgentInferencePlugin(provider) {
+    return defineAgentCapacityPlugin({
+        key: 'inference',
+        displayName: 'Agent Inference Provider',
+        description: `Model calls through the ${provider} inference provider.`,
+        specId: 'example-inference',
+        octicon: 'cpu',
+        emoji: '🧠',
+        createPayload: { inferenceProvider: provider },
+    });
+}
+export const AgentInferencePlugin = createAgentInferencePlugin('local');
+export default AgentInferencePlugin;

package/lib/loop/plugins/agent-mcp/index.d.ts

@@ -0,0 +1,3 @@
+export declare const AGENT_MCP_PLUGIN_NAME = "@datalayer/loop-plugin-agent-mcp";
+export declare const AgentMcpPlugin: import("@datalayer/reactor").ReactorPlugin<Record<string, never>, unknown, unknown>;
+export default AgentMcpPlugin;

package/lib/loop/plugins/agent-mcp/index.js

@@ -0,0 +1,25 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * `@datalayer/loop-plugin-agent-mcp` — the capacity, as a plugin.
+ *
+ * Mounts the `example-mcp` agent and offers what it is worth asking. Cast
+ * from the shared capacity mould; see `loop/plugins/agent-capacity`.
+ *
+ * The openers are the spec's own.
+ *
+ * @module loop/plugins/agent-mcp
+ */
+import { defineAgentCapacityPlugin } from '../agent-capacity';
+export const AGENT_MCP_PLUGIN_NAME = '@datalayer/loop-plugin-agent-mcp';
+export const AgentMcpPlugin = defineAgentCapacityPlugin({
+    key: 'mcp',
+    displayName: 'Agent MCP',
+    description: 'Agent MCP',
+    specId: 'example-mcp',
+    octicon: 'plug',
+    emoji: '🔌',
+});
+export default AgentMcpPlugin;

package/lib/loop/plugins/agent-memory/index.d.ts

@@ -0,0 +1,3 @@
+export declare const AGENT_MEMORY_PLUGIN_NAME = "@datalayer/loop-plugin-agent-memory";
+export declare const AgentMemoryPlugin: import("@datalayer/reactor").ReactorPlugin<Record<string, never>, unknown, unknown>;
+export default AgentMemoryPlugin;

package/lib/loop/plugins/agent-memory/index.js

@@ -0,0 +1,25 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * `@datalayer/loop-plugin-agent-memory` — the capacity, as a plugin.
+ *
+ * Mounts the `example-memory` agent and offers what it is worth asking. Cast
+ * from the shared capacity mould; see `loop/plugins/agent-capacity`.
+ *
+ * The openers are the spec's own.
+ *
+ * @module loop/plugins/agent-memory
+ */
+import { defineAgentCapacityPlugin } from '../agent-capacity';
+export const AGENT_MEMORY_PLUGIN_NAME = '@datalayer/loop-plugin-agent-memory';
+export const AgentMemoryPlugin = defineAgentCapacityPlugin({
+    key: 'memory',
+    displayName: 'Agent Memory',
+    description: 'Agent with persistent memory',
+    specId: 'example-memory',
+    octicon: 'database',
+    emoji: '🧠',
+});
+export default AgentMemoryPlugin;

package/lib/loop/plugins/agent-monitoring/index.d.ts

@@ -0,0 +1,3 @@
+export declare const AGENT_MONITORING_PLUGIN_NAME = "@datalayer/loop-plugin-agent-monitoring";
+export declare const AgentMonitoringPlugin: import("@datalayer/reactor").ReactorPlugin<Record<string, never>, unknown, unknown>;
+export default AgentMonitoringPlugin;

package/lib/loop/plugins/agent-monitoring/index.js

@@ -0,0 +1,25 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * `@datalayer/loop-plugin-agent-monitoring` — the capacity, as a plugin.
+ *
+ * Mounts the `example-monitoring` agent and offers what it is worth asking. Cast
+ * from the shared capacity mould; see `loop/plugins/agent-capacity`.
+ *
+ * The openers are the spec's own.
+ *
+ * @module loop/plugins/agent-monitoring
+ */
+import { defineAgentCapacityPlugin } from '../agent-capacity';
+export const AGENT_MONITORING_PLUGIN_NAME = '@datalayer/loop-plugin-agent-monitoring';
+export const AgentMonitoringPlugin = defineAgentCapacityPlugin({
+    key: 'monitoring',
+    displayName: 'Agent Monitoring',
+    description: '${alerts.length} active alert${alerts.length !== 1 ? ',
+    specId: 'example-monitoring',
+    octicon: 'pulse',
+    emoji: '📈',
+});
+export default AgentMonitoringPlugin;

package/lib/loop/plugins/agent-notifications/index.d.ts

@@ -0,0 +1,3 @@
+export declare const AGENT_NOTIFICATIONS_PLUGIN_NAME = "@datalayer/loop-plugin-agent-notifications";
+export declare const AgentNotificationsPlugin: import("@datalayer/reactor").ReactorPlugin<Record<string, never>, unknown, unknown>;
+export default AgentNotificationsPlugin;

package/lib/loop/plugins/agent-notifications/index.js

@@ -0,0 +1,25 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * `@datalayer/loop-plugin-agent-notifications` — the capacity, as a plugin.
+ *
+ * Mounts the `example-notifications` agent and offers what it is worth asking. Cast
+ * from the shared capacity mould; see `loop/plugins/agent-capacity`.
+ *
+ * The openers are the spec's own.
+ *
+ * @module loop/plugins/agent-notifications
+ */
+import { defineAgentCapacityPlugin } from '../agent-capacity';
+export const AGENT_NOTIFICATIONS_PLUGIN_NAME = '@datalayer/loop-plugin-agent-notifications';
+export const AgentNotificationsPlugin = defineAgentCapacityPlugin({
+    key: 'notifications',
+    displayName: 'Agent Notifications',
+    description: '${unreadCount} unread notification${unreadCount !== 1 ? ',
+    specId: 'example-notifications',
+    octicon: 'bell',
+    emoji: '🔔',
+});
+export default AgentNotificationsPlugin;

package/lib/loop/plugins/agent-otel/index.d.ts

@@ -0,0 +1,3 @@
+export declare const AGENT_OTEL_PLUGIN_NAME = "@datalayer/loop-plugin-agent-otel";
+export declare const AgentOtelPlugin: import("@datalayer/reactor").ReactorPlugin<Record<string, never>, unknown, unknown>;
+export default AgentOtelPlugin;

package/lib/loop/plugins/agent-otel/index.js

@@ -0,0 +1,25 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * `@datalayer/loop-plugin-agent-otel` — observability, as a capacity.
+ *
+ * Mounts the `example-otel` agent: a conversation over the workspace's own
+ * traces, logs and metrics. Cast from the shared capacity mould.
+ *
+ * The openers are the spec's own.
+ *
+ * @module loop/plugins/agent-otel
+ */
+import { defineAgentCapacityPlugin } from '../agent-capacity';
+export const AGENT_OTEL_PLUGIN_NAME = '@datalayer/loop-plugin-agent-otel';
+export const AgentOtelPlugin = defineAgentCapacityPlugin({
+    key: 'otel',
+    displayName: 'Agent OTel',
+    description: 'Connect an agent to your traces, logs, and metrics and chat about them.',
+    specId: 'example-otel',
+    octicon: 'telescope',
+    emoji: '🔭',
+});
+export default AgentOtelPlugin;

package/lib/loop/plugins/agent-outputs/index.d.ts

@@ -0,0 +1,3 @@
+export declare const AGENT_OUTPUTS_PLUGIN_NAME = "@datalayer/loop-plugin-agent-outputs";
+export declare const AgentOutputsPlugin: import("@datalayer/reactor").ReactorPlugin<Record<string, never>, unknown, unknown>;
+export default AgentOutputsPlugin;

package/lib/loop/plugins/agent-outputs/index.js

@@ -0,0 +1,25 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * `@datalayer/loop-plugin-agent-outputs` — structured outputs, as a capacity.
+ *
+ * Mounts the `example-output` agent, which answers with exactly one
+ * structured block — a Markdown table, a JSON object, an ECharts chart or a
+ * downloadable file — for the example's side panel to detect and render.
+ * Cast from the shared capacity mould; the openers are the spec's own.
+ *
+ * @module loop/plugins/agent-outputs
+ */
+import { defineAgentCapacityPlugin } from '../agent-capacity';
+export const AGENT_OUTPUTS_PLUGIN_NAME = '@datalayer/loop-plugin-agent-outputs';
+export const AgentOutputsPlugin = defineAgentCapacityPlugin({
+    key: 'outputs',
+    displayName: 'Agent Outputs',
+    description: 'Structured outputs: a table, JSON, a chart or a file per answer.',
+    specId: 'example-output',
+    octicon: 'log',
+    emoji: '📤',
+});
+export default AgentOutputsPlugin;

package/lib/loop/plugins/agent-parameters/index.d.ts

@@ -0,0 +1,3 @@
+export declare const AGENT_PARAMETERS_PLUGIN_NAME = "@datalayer/loop-plugin-agent-parameters";
+export declare const AgentParametersPlugin: import("@datalayer/reactor").ReactorPlugin<Record<string, never>, unknown, unknown>;
+export default AgentParametersPlugin;

package/lib/loop/plugins/agent-parameters/index.js

@@ -0,0 +1,25 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * `@datalayer/loop-plugin-agent-parameters` — the capacity, as a plugin.
+ *
+ * Mounts the `example-parameters` agent and offers what it is worth asking. Cast
+ * from the shared capacity mould; see `loop/plugins/agent-capacity`.
+ *
+ * The openers are the spec's own.
+ *
+ * @module loop/plugins/agent-parameters
+ */
+import { defineAgentCapacityPlugin } from '../agent-capacity';
+export const AGENT_PARAMETERS_PLUGIN_NAME = '@datalayer/loop-plugin-agent-parameters';
+export const AgentParametersPlugin = defineAgentCapacityPlugin({
+    key: 'parameters',
+    displayName: 'Agent Parameters',
+    description: 'Role: ${String(formData.role ?? ',
+    specId: 'example-parameters',
+    octicon: 'sliders',
+    emoji: '🎚️',
+});
+export default AgentParametersPlugin;

package/lib/loop/plugins/agent-skills/index.d.ts

@@ -0,0 +1,3 @@
+export declare const AGENT_SKILLS_PLUGIN_NAME = "@datalayer/loop-plugin-agent-skills";
+export declare const AgentSkillsPlugin: import("@datalayer/reactor").ReactorPlugin<Record<string, never>, unknown, unknown>;
+export default AgentSkillsPlugin;

package/lib/loop/plugins/agent-skills/index.js

@@ -0,0 +1,25 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * `@datalayer/loop-plugin-agent-skills` — the capacity, as a plugin.
+ *
+ * Mounts the `example-skills` agent and offers what it is worth asking. Cast
+ * from the shared capacity mould; see `loop/plugins/agent-capacity`.
+ *
+ * The openers are the spec's own.
+ *
+ * @module loop/plugins/agent-skills
+ */
+import { defineAgentCapacityPlugin } from '../agent-capacity';
+export const AGENT_SKILLS_PLUGIN_NAME = '@datalayer/loop-plugin-agent-skills';
+export const AgentSkillsPlugin = defineAgentCapacityPlugin({
+    key: 'skills',
+    displayName: 'Agent Skills',
+    description: 'Agent Skills',
+    specId: 'example-skills',
+    octicon: 'mortar-board',
+    emoji: '🎓',
+});
+export default AgentSkillsPlugin;

package/lib/loop/plugins/agent-subagents/index.d.ts

@@ -0,0 +1,3 @@
+export declare const AGENT_SUBAGENTS_PLUGIN_NAME = "@datalayer/loop-plugin-agent-subagents";
+export declare const AgentSubagentsPlugin: import("@datalayer/reactor").ReactorPlugin<Record<string, never>, unknown, unknown>;
+export default AgentSubagentsPlugin;

package/lib/loop/plugins/agent-subagents/index.js

@@ -0,0 +1,25 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * `@datalayer/loop-plugin-agent-subagents` — the capacity, as a plugin.
+ *
+ * Mounts the `example-subagents` agent and offers what it is worth asking. Cast
+ * from the shared capacity mould; see `loop/plugins/agent-capacity`.
+ *
+ * The openers are the spec's own.
+ *
+ * @module loop/plugins/agent-subagents
+ */
+import { defineAgentCapacityPlugin } from '../agent-capacity';
+export const AGENT_SUBAGENTS_PLUGIN_NAME = '@datalayer/loop-plugin-agent-subagents';
+export const AgentSubagentsPlugin = defineAgentCapacityPlugin({
+    key: 'subagents',
+    displayName: 'Agent Subagents',
+    description: 'Multi-agent delegation with researcher & writer',
+    specId: 'example-subagents',
+    octicon: 'people',
+    emoji: '👥',
+});
+export default AgentSubagentsPlugin;

package/lib/loop/plugins/agent-tool-approvals/index.d.ts

@@ -0,0 +1,11 @@
+export declare const AGENT_TOOL_APPROVALS_PLUGIN_NAME = "@datalayer/loop-plugin-agent-tool-approvals";
+export interface ToolApprovalsCapacityOptions {
+    /** The agentspec to mount; the example lets a person pick another. */
+    specId?: string;
+    /** Create the agent with approvals switched off, to compare. */
+    disableToolApprovals?: boolean;
+}
+/** The capacity for a spec and an approvals setting: what a page that offers both builds per choice. */
+export declare function createAgentToolApprovalsPlugin(options?: ToolApprovalsCapacityOptions): import("@datalayer/reactor").ReactorPlugin<Record<string, never>, unknown, unknown>;
+export declare const AgentToolApprovalsPlugin: import("@datalayer/reactor").ReactorPlugin<Record<string, never>, unknown, unknown>;
+export default AgentToolApprovalsPlugin;

package/lib/loop/plugins/agent-tool-approvals/index.js

@@ -0,0 +1,38 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * `@datalayer/loop-plugin-agent-tool-approvals` — tool approvals, as a capacity.
+ *
+ * Mounts the `example-tool-approvals` agent: two echo tools, one of which is
+ * held for a person's approval before it runs. Cast from the shared capacity
+ * mould; the openers are the spec's own.
+ *
+ * @module loop/plugins/agent-tool-approvals
+ */
+import { defineAgentCapacityPlugin } from '../agent-capacity';
+export const AGENT_TOOL_APPROVALS_PLUGIN_NAME = '@datalayer/loop-plugin-agent-tool-approvals';
+/** The capacity for a spec and an approvals setting: what a page that offers both builds per choice. */
+export function createAgentToolApprovalsPlugin(options = {}) {
+    const specId = options.specId ?? 'example-tool-approvals';
+    const disableToolApprovals = options.disableToolApprovals ?? false;
+    return defineAgentCapacityPlugin({
+        key: 'tool-approvals',
+        displayName: 'Agent Tool Approvals',
+        description: disableToolApprovals
+            ? 'Runtime tools with approvals switched off, to compare.'
+            : 'Runtime tools, the sensitive one held for a person to approve.',
+        specId,
+        octicon: 'shield-check',
+        emoji: '🛡️',
+        createPayload: {
+            enable_skills: false,
+            skills: [],
+            tools: ['runtime-echo', 'runtime-sensitive-echo'],
+            disableToolApprovals,
+        },
+    });
+}
+export const AgentToolApprovalsPlugin = createAgentToolApprovalsPlugin();
+export default AgentToolApprovalsPlugin;

package/lib/loop/plugins/agent-triggers/index.d.ts

@@ -0,0 +1,3 @@
+export declare const AGENT_TRIGGERS_PLUGIN_NAME = "@datalayer/loop-plugin-agent-triggers";
+export declare const AgentTriggersPlugin: import("@datalayer/reactor").ReactorPlugin<Record<string, never>, unknown, unknown>;
+export default AgentTriggersPlugin;

package/lib/loop/plugins/agent-triggers/index.js

@@ -0,0 +1,26 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * `@datalayer/loop-plugin-agent-triggers` — triggers, as a capacity.
+ *
+ * Mounts the `example-one-trigger` agent: an agent whose turns are started
+ * by cron schedules, webhooks and event subscriptions rather than only by a
+ * person typing. Cast from the shared capacity mould.
+ *
+ * The openers are the spec's own.
+ *
+ * @module loop/plugins/agent-triggers
+ */
+import { defineAgentCapacityPlugin } from '../agent-capacity';
+export const AGENT_TRIGGERS_PLUGIN_NAME = '@datalayer/loop-plugin-agent-triggers';
+export const AgentTriggersPlugin = defineAgentCapacityPlugin({
+    key: 'triggers',
+    displayName: 'Agent Triggers',
+    description: 'Turns started by cron schedules, webhooks and event subscriptions.',
+    specId: 'example-one-trigger',
+    octicon: 'clock',
+    emoji: '⏰',
+});
+export default AgentTriggersPlugin;

package/lib/loop/plugins/agents/AgentSummaryPanel.d.ts

@@ -0,0 +1,20 @@
+/**
+ * What this workspace is talking to, in its own header.
+ *
+ * The examples shell drew this for every example from a store it kept itself,
+ * which worked while an example *was* the agent. This workspace is not: the
+ * agent it addresses is chosen inside it, by this plugin, and can change
+ * without the page around it knowing — so a summary assembled outside was
+ * describing a session it could not see.
+ *
+ * Assembled here instead, from the sandbox service and the workspace context,
+ * and contributed to the workspace's own header like every other control.
+ *
+ * @module loop/plugins/agents/AgentSummaryPanel
+ */
+import type { JSX } from 'react';
+import type { LoopWorkspaceContext } from '../../core';
+export declare function AgentSummaryPanel({ workspace, }: {
+    workspace: LoopWorkspaceContext;
+}): JSX.Element | null;
+export default AgentSummaryPanel;

package/lib/loop/plugins/agents/AgentSummaryPanel.js

@@ -0,0 +1,50 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useSignalValue } from '@datalayer/reactor/react';
+import { AgentSummary } from '../../../components/agents/AgentSummary';
+import { AGENTSPECS } from '../../../specs/agents/agents';
+import { TARGET_SPECS } from './switchable';
+import { useSandboxService } from './useSandboxService';
+import { useOptionalTeamSelection } from './useTeamSelection';
+/* Stand-ins for a workspace with no sandbox plugin or no team. `peek` as well
+   as `value`: `useSignalValue` subscribes, and a bare object is not a signal. */
+const NO_TARGET = {
+    value: undefined,
+    peek: () => undefined,
+};
+const NO_MEMBER = {
+    value: undefined,
+    peek: () => undefined,
+};
+export function AgentSummaryPanel({ workspace, }) {
+    const service = useSandboxService();
+    const target = useSignalValue(service?.target ?? NO_TARGET);
+    const team = useOptionalTeamSelection();
+    const active = useSignalValue(team?.active ?? NO_MEMBER);
+    if (!service) {
+        return null;
+    }
+    const snapshot = workspace.sandbox;
+    /*
+     * The member being addressed, when there is a team; the workspace's agent
+     * otherwise. The two differ precisely when a team is in play, and the one a
+     * prompt reaches is the one worth naming.
+     */
+    const specId = active?.specId || workspace.agentId;
+    const spec = AGENTSPECS[specId];
+    const summary = {
+        agentName: active?.name || spec?.name || workspace.agentId,
+        location: target ? TARGET_SPECS[target].label : '—',
+        specId,
+        harness: spec?.harness,
+        // Where it runs and what turns its loop, as the workspace has it. The
+        // sandbox reports the second half; `variant` is the pair.
+        variant: snapshot.variant,
+        status: snapshot.state,
+        baseUrl: snapshot.agentBaseUrl || workspace.serverUrl,
+        sandboxBaseUrl: snapshot.jupyterUrl,
+        agentId: workspace.agentId,
+        isReady: snapshot.state === 'running',
+    };
+    return _jsx(AgentSummary, { summary: summary });
+}
+export default AgentSummaryPanel;