@stratusagent/gateway 0.6.0 → 0.8.0

package/dist/index.d.ts

@@ -1,7 +1,16 @@
 import { EventBus, type AgentDefinition, type ApprovalAnswer, type ApprovalPolicy, type JsonObject, type Session, type SessionStatus, type SessionStore, type ToolRisk } from '@stratusagent/core';
-import { type ParsedSoul } from '@stratusagent/agents';
+import { type ParsedSoul, type ScheduleRecord } from '@stratusagent/agents';
+import { type SchedulerLimits } from './schedules.ts';
+export { SqliteScheduleStore, createSchedulerRuntime, type ScheduleStoreLike, type SchedulerLimits, type SchedulerRuntime, type SchedulerRuntimeOptions, } from './schedules.ts';
 import { type OptionalModuleHost } from '@stratusagent/plugins';
 import { type PluginsConfig, type RuntimeSelection, type StateEnvironment } from '@stratusagent/state';
+/**
+ * Where a daemon with no explicit `sessionDbPath` keeps its database — the
+ * one rule for it, exported because `stratus schedules` opens the same file
+ * from another process and a re-derived copy of this join is how the CLI
+ * ends up auditing a database no daemon writes.
+ */
+export declare const defaultSessionDbPath: (env?: StateEnvironment) => string;
 /**
  * Durable session storage on node:sqlite (unflagged on Node 22.13+). The
  * whole session — messages, status, and metadata, including provider replay
@@ -93,6 +102,21 @@ export interface GatewayChannelAdapter {
     name: string;
     start(gateway: Gateway): Promise<void>;
     stop(): Promise<void>;
+    /**
+     * The addressable outbound seam, mirroring
+     * `@stratusagent/channels`' `ChannelAdapter.resolveOutbound` structurally
+     * for the same reason the rest of this interface does. Optional: an
+     * adapter with no concept of a destination simply lacks it, and the
+     * gateway treats absence as "this channel cannot be spoken through".
+     * Implementations MUST reject a destination they could not deliver to,
+     * with a message fit to show the person who named it.
+     */
+    resolveOutbound?(address: {
+        agentId: string;
+        to: string;
+    }): Promise<{
+        post(text: string): Promise<unknown>;
+    }>;
 }
 /**
  * Where a session came from, as the gateway reports it. Structural for the
@@ -115,6 +139,16 @@ export interface SessionRouting {
  */
 export interface ApprovalTransport {
     request: ApprovalRequester;
+    /**
+     * The schedule carve-out, for a policy that understands destinations
+     * (`@stratusagent/permissions`' `destinations` option takes exactly this
+     * shape). True when the session is a firing of a schedule that still
+     * exists, belongs to this agent, and was approved with this destination
+     * — the gateway answers from the schedule row, so cancelling revokes.
+     */
+    destinations: {
+        isPreauthorized(session: Session, destination: string): boolean;
+    };
 }
 /**
  * A parked call, published for anyone who can reach a person. Mirrors
@@ -199,12 +233,26 @@ export interface GatewayTool {
     /** Whether that package is trusted to declare a tool `safe`. */
     trusted?: boolean;
 }
+/** One skill this daemon serves — identity and provenance, never the body. */
+export interface GatewaySkill {
+    /** Canonical id: bare for an operator-installed skill, `<package>:<skill>` for a plugin's. */
+    id: string;
+    name: string;
+    description: string;
+    /** The bare id a plugin's skill also answers to, while no one else claims it. */
+    alias?: string;
+    /** The plugin package that contributed it; absent for operator-installed skills. */
+    package?: string;
+    /** Where the SKILL.md lives. */
+    path?: string;
+}
 /** A plugin this daemon was asked to load, and what came of it. */
 export interface GatewayPluginStatus {
     package: string;
     name?: string;
     trusted?: boolean;
     tools?: GatewayTool[];
+    skills?: GatewaySkill[];
     /** Present when the plugin did not load, and the only field that is. */
     error?: string;
 }
@@ -235,6 +283,12 @@ export interface GatewayOptions {
     idleTimeoutMs?: number;
     /** Session database path. Default ~/.stratus/sessions.db. */
     sessionDbPath?: string;
+    /**
+     * Scheduler limits — the interval floor, the per-agent cap on concurrent
+     * scheduled turns, and the tick cadence. Defaults are production values;
+     * tests lower them.
+     */
+    schedules?: SchedulerLimits;
     /**
      * Plugins to load, keyed by package name — the `plugins` block, which the
      * caller has already read from a **trusted** config. The gateway does not
@@ -308,6 +362,19 @@ export interface Gateway {
     activeTurnId(sessionId: string): string | undefined;
     /** Every call parked on a human right now, oldest first. */
     pendingApprovals(): PendingApproval[];
+    /**
+     * Every schedule the fleet has set, oldest first — the audit list the
+     * spec demands: an agent that scheduled something an operator cannot see
+     * or stop is a bug. Each row is also the scope of its own destination
+     * grant, so this doubles as the list of standing permissions to speak.
+     */
+    schedules(): ScheduleRecord[];
+    /**
+     * Cancel any agent's schedule — the operator's stop button, and the
+     * revocation of the destination grant riding on the row. False when no
+     * such schedule exists.
+     */
+    cancelSchedule(scheduleId: string): boolean;
     /**
      * Every registered tool, with the risk it will actually be judged at and
      * the package it came from.
@@ -319,6 +386,12 @@ export interface Gateway {
      * itself the answer for them.
      */
     tools(): GatewayTool[];
+    /**
+     * Every skill this daemon serves — operator-installed and
+     * plugin-contributed — with the ids an allowlist can name. Descriptors
+     * only: bodies stay behind `skill.read`, on the agent's own turn.
+     */
+    skills(): GatewaySkill[];
     /**
      * The plugins this daemon loaded, and the ones it could not — a plugin an
      * operator enabled that failed to load is exactly what they need to see,

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,13 +1,30 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
 import { createHash, randomUUID } from 'node:crypto';
 import { chmodSync, mkdirSync } from 'node:fs';
 import path from 'node:path';
 import { DatabaseSync } from 'node:sqlite';
-import { AgentRegistry, AgentRunner, EventBus, RunAbortedError, ToolRegistry, readPendingApproval, } from '@stratusagent/core';
-import { createDelegateTool, createRememberTool, } from '@stratusagent/agents';
+import { AgentRegistry, AgentRunner, EventBus, RunAbortedError, SkillRegistry, ToolRegistry, createSkillReadTool, missingSkillRequirements, readPendingApproval, } from '@stratusagent/core';
+import { createDelegateTool, createForgetTool, createMessageSendTool, createRecallTool, createRememberTool, createScheduleTools, } from '@stratusagent/agents';
+import { createSchedulerRuntime, isScheduleSessionId, SqliteScheduleStore, SCHEDULE_SESSION_ID_PREFIX, } from "./schedules.js";
+export { SqliteScheduleStore, createSchedulerRuntime, } from "./schedules.js";
 import { createLocalCommandExecutor } from '@stratusagent/executor-local';
 import { loadPlugins, } from '@stratusagent/plugins';
-import { createDemoTool, createFileMemoryStore, createRuntimeProvider, DEFAULT_STRATUS_AGENT, loadRosterSouls, FALLBACK_ACTIVE_METADATA_KEY, loadSoulFile, memoryFilePath, migrateLegacyMemory, ConfigFileError, loadConfigFile, resolveConfigLocation, resolveConfiguredSoul, resolveRuntimeConfig, applySoulPins, stratusHomePath, workspacesDirPath, withLegacyDefaultMemories, } from '@stratusagent/state';
+import { createDemoTool, createFileMemoryStore, createRuntimeProvider, DEFAULT_STRATUS_AGENT, loadOperatorSkills, loadRosterSouls, FALLBACK_ACTIVE_METADATA_KEY, loadSoulFile, memoryFilePath, migrateLegacyMemory, ConfigFileError, loadConfigFile, resolveConfigLocation, resolveConfiguredSoul, resolveRuntimeConfig, applySoulPins, stratusHomePath, workspacesDirPath, withLegacyDefaultMemories, } from '@stratusagent/state';
 const SESSIONS_DB_FILENAME = 'sessions.db';
+/**
+ * Where a daemon with no explicit `sessionDbPath` keeps its database — the
+ * one rule for it, exported because `stratus schedules` opens the same file
+ * from another process and a re-derived copy of this join is how the CLI
+ * ends up auditing a database no daemon writes.
+ */
+export const defaultSessionDbPath = (env = {}) => path.join(stratusHomePath(env), SESSIONS_DB_FILENAME);
 const DEFAULT_IDLE_TIMEOUT_MS = 120_000;
 /**
  * How long a parked call waits for a person. Long enough to survive a
@@ -55,6 +72,12 @@ export class SqliteSessionStore {
         // (the user_version pragma is a real page-one write) so the loop
         // below covers them for the connection's whole lifetime.
         this.db.exec('PRAGMA journal_mode = WAL');
+        // A busy timeout, because this file has a second writer: `stratus
+        // schedules cancel` opens its own connection to the schedules table
+        // living here, and WAL serializes writers file-wide — a session save
+        // racing that delete would otherwise throw `database is locked` rather
+        // than wait its brief turn.
+        this.db.exec('PRAGMA busy_timeout = 5000');
         this.db.exec(`
       CREATE TABLE IF NOT EXISTS sessions (
         id TEXT PRIMARY KEY,
@@ -225,10 +248,48 @@ export const createGateway = (options = {}) => {
     // The default database lives in the gateway-owned ~/.stratus, which is
     // tightened to owner-only; a caller-supplied path may sit in a shared
     // directory that must not be chmodded from under other processes.
+    const sessionDbPath = options.sessionDbPath ?? defaultSessionDbPath(env);
     const store = options.sessionDbPath
-        ? new SqliteSessionStore(options.sessionDbPath)
-        : new SqliteSessionStore(path.join(stratusHomePath(env), SESSIONS_DB_FILENAME), { ownedDirectory: true });
+        ? new SqliteSessionStore(sessionDbPath)
+        : new SqliteSessionStore(sessionDbPath, { ownedDirectory: true });
     const memory = withLegacyDefaultMemories(createFileMemoryStore(memoryFilePath(env)));
+    // ---- schedules ----------------------------------------------------------
+    // The same database sessions live in — one file to back up — through the
+    // schedule store's own connection (see its docs for why).
+    const scheduleStore = new SqliteScheduleStore(sessionDbPath);
+    /**
+     * The write side of an addressable destination, through whichever
+     * started channel serves its kind. Resolution happens per call against
+     * the live adapter list, so a channel that failed to start is honestly
+     * "cannot address" rather than a stale reference — and rejecting is how
+     * both callers (schedule creation, `message.send`) hear why.
+     */
+    const outboundFor = async (agentId, destination) => {
+        const adapter = startedChannels.find((candidate) => candidate.name === destination.channel && candidate.resolveOutbound);
+        if (!adapter?.resolveOutbound) {
+            throw new Error(`No running channel can deliver to '${destination.channel}' destinations — `
+                + (startedChannels.length === 0
+                    ? 'no channel adapters are running.'
+                    : `running channels: ${startedChannels.map((candidate) => candidate.name).join(', ')}.`));
+        }
+        return adapter.resolveOutbound({ agentId, to: destination.to });
+    };
+    const scheduler = createSchedulerRuntime({
+        store: scheduleStore,
+        // Late-bound on purpose: firings go through the gateway's own dispatch
+        // path — single-flight, watchdog, refusal while stopping — never a
+        // second runner. Through the firing-only entry, which is allowed into
+        // the reserved `schedule:` namespace the public `dispatch` refuses.
+        dispatch: (input) => dispatchScheduledFiring(input),
+        validateDestination: async (agentId, destination) => {
+            await outboundFor(agentId, destination);
+        },
+        sessionStatus: async (sessionId) => (await store.get(sessionId))?.status,
+        hasAgent: (agentId) => registry.get(agentId) !== undefined,
+        ...(options.schedules ? { limits: options.schedules } : {}),
+        log,
+        warn,
+    });
     // ---- approval brokering -------------------------------------------------
     const approvalTimeoutMs = options.approvalTimeoutMs ?? DEFAULT_APPROVAL_TIMEOUT_MS;
     // Refused at construction, not absorbed: a negative or NaN timeout fails
@@ -464,7 +525,12 @@ export const createGateway = (options = {}) => {
         };
     };
     const configuredApprovals = typeof options.approvals === 'function'
-        ? options.approvals({ request: requestApproval })
+        ? options.approvals({
+            request: requestApproval,
+            destinations: {
+                isPreauthorized: (session, destination) => scheduler.isPreauthorized(session, destination),
+            },
+        })
         : options.approvals;
     /**
      * Every approval opens a tool phase, whatever policy answers it.
@@ -607,6 +673,17 @@ export const createGateway = (options = {}) => {
                 registry.unregister(id);
             }
         }
+        // Advisory, per the skills spec: a skill may say which toolsets its
+        // procedure expects (`requires:`), and an agent enabling it without
+        // them gets a warning at load — never a refusal, because a skill is
+        // prose and can degrade. The check itself is the kernel's
+        // (`missingSkillRequirements`), shared with the CLI's local runs so
+        // both hosts warn about the same configuration.
+        for (const agent of registry.list()) {
+            for (const { skill, missing } of missingSkillRequirements(agent, skillCatalog)) {
+                warn(`agent ${agent.id} enables skill ${skill.id}, which expects tools the agent is not allowed: ${missing.join(', ')}`);
+            }
+        }
     };
     /**
      * Roster rebuilds, one at a time.
@@ -675,11 +752,34 @@ export const createGateway = (options = {}) => {
     const toolProvenance = new Map();
     let loadedPlugins = [];
     let pluginFailures = [];
+    const skillCatalog = new SkillRegistry();
+    let operatorSkills = [];
     tools.register(createDemoTool());
     tools.register(createRememberTool(memory));
+    tools.register(createRecallTool(memory));
+    tools.register(createForgetTool(memory));
+    // Registered here rather than left to the first runner, so `tools()`
+    // lists the reader before anything dispatches. The allowlist resolver
+    // mirrors the runner's own sourcing — the definition travelling with the
+    // session, then the roster — so the tool refuses exactly what the
+    // runner's gates refuse.
+    tools.register(createSkillReadTool(skillCatalog, {
+        allowlistFor: (session) => session.agent.skills ?? registry.get(session.agent.id)?.skills,
+    }));
     // Delegation is dispatcher-backed, not runner-capturing: the target agent
     // runs through the same per-provider routing as a direct dispatch, so a
     // delegated specialist uses their own provider and credentials.
+    // Scheduling and outbound speech are gateway-registered for the same
+    // reason delegation is: the tools need the dispatcher, the store, and
+    // the channels, and the plugin context carries none of them. Souls still
+    // opt in by allowlist (`schedule.*`, `message.send`) like any other tool.
+    for (const scheduleTool of createScheduleTools(scheduler.handle)) {
+        tools.register(scheduleTool);
+    }
+    tools.register(createMessageSendTool(async ({ agentId, destination, text }) => {
+        const connection = await outboundFor(agentId, destination);
+        await connection.post(text);
+    }));
     tools.register(createDelegateTool({
         registry,
         dispatch: (input) => dispatchInternal({
@@ -730,6 +830,7 @@ export const createGateway = (options = {}) => {
             store,
             bus,
             agents: registry,
+            skills: skillCatalog,
             memory,
             streaming: true,
             ...(options.maxTurns !== undefined ? { maxTurns: options.maxTurns } : {}),
@@ -1243,10 +1344,34 @@ export const createGateway = (options = {}) => {
         });
         return turn;
     };
+    /**
+     * A scheduled firing's own dispatch — single-flight and stopping-aware
+     * like the public one, but permitted into the reserved `schedule:`
+     * namespace the public one refuses. Firings are the only writers of that
+     * namespace, which is what keeps the destination carve-out unforgeable:
+     * an external message can never share, resume, or race a firing's
+     * session, so `isPreauthorized` can trust that a `schedule:` session
+     * running is the scheduler's turn and no one else's.
+     */
+    const dispatchScheduledFiring = (input) => {
+        if (stopping) {
+            throw new Error('The gateway is stopping and no longer accepts new work.');
+        }
+        return onSessionChain(input.sessionId, () => dispatchInternal(input));
+    };
     const dispatch = async (input) => {
         if (stopping) {
             throw new Error('The gateway is stopping and no longer accepts new work.');
         }
+        // The reserved namespace is the scheduler's alone. A caller that could
+        // name a firing's session id — derivable from `GET /schedules` — would
+        // otherwise queue a turn of its own behind the firing (single-flight)
+        // and run inside the grant, using `message.send` to the schedule's
+        // approved destination without its own approval. Refused here, at the
+        // one door every external dispatch comes through.
+        if (isScheduleSessionId(input.sessionId)) {
+            throw new Error(`Session ids beginning with "${SCHEDULE_SESSION_ID_PREFIX}" are reserved for scheduled firings and cannot be dispatched externally.`);
+        }
         const { turnId } = input;
         if (turnId === undefined) {
             return onSessionChain(input.sessionId, () => dispatchInternal(input));
@@ -1283,9 +1408,10 @@ export const createGateway = (options = {}) => {
             config: configured,
             host: options.pluginHost ?? {
                 resolve: (specifier) => import.meta.resolve(specifier),
-                import: (specifier) => import(specifier),
+                import: (specifier) => import(__rewriteRelativeImportExtension(specifier)),
             },
             tools,
+            skills: skillCatalog,
             bus,
             workspaceRoot: workspacesDirPath(env),
         });
@@ -1295,12 +1421,28 @@ export const createGateway = (options = {}) => {
             for (const tool of plugin.tools) {
                 toolProvenance.set(tool.name, { package: plugin.package, trusted: plugin.trusted });
             }
-            log(`plugin ${plugin.package} loaded — ${plugin.tools.map((tool) => `${tool.name} (${tool.risk})`).join(', ') || 'no tools'}`);
+            const contributed = [
+                ...plugin.tools.map((tool) => `${tool.name} (${tool.risk})`),
+                ...plugin.skills.map((skill) => `skill ${skill.id}`),
+            ];
+            log(`plugin ${plugin.package} loaded — ${contributed.join(', ') || 'no tools'}`);
         }
         for (const failure of result.failures) {
             warn(`plugin ${failure.package} did not load: ${failure.reason}`);
         }
     };
+    /**
+     * Load the operator's `~/.stratus/skills/` into the catalog. Before the
+     * plugins, deliberately: an operator's bare id outranks a plugin's bare
+     * alias for the same name, and the plugin's skill stays reachable by its
+     * qualified `<package>:<skill>` form.
+     */
+    const startSkills = async () => {
+        operatorSkills = await loadOperatorSkills(env, skillCatalog, warn);
+        for (const skill of operatorSkills) {
+            log(`skill ${skill.id} loaded from ${skill.path}`);
+        }
+    };
     /**
      * Everything after the plugins: the roster, the channels, and the sweeps
      * that need both. Split out so `start()` can wrap it in the cleanup a
@@ -1336,6 +1478,11 @@ export const createGateway = (options = {}) => {
                 }
             }
         }
+        // After the channels, so a catch-up firing has somewhere to report and
+        // the missed-window log lines land in a gateway whose surfaces are
+        // listening. The sweep inside is quick (store reads); the firings it
+        // may start are tracked, not awaited.
+        await scheduler.start();
         // Last, and not awaited: recovery re-asks, so it needs the channels
         // above already listening — but a turn parked behind a slow approver
         // must not hold up start(), or a daemon with one outstanding request
@@ -1371,6 +1518,9 @@ export const createGateway = (options = {}) => {
             // Before the roster and before channels: a turn must never arrive for
             // an agent whose soul lists a tool the daemon has not registered yet,
             // which would refuse the call as "not permitted" and blame the soul.
+            // Skills first for the same reason — and before the plugins, so the
+            // operator's bare ids win their aliases (see startSkills).
+            await startSkills();
             await startPlugins();
             try {
                 await startServing();
@@ -1394,6 +1544,11 @@ export const createGateway = (options = {}) => {
             // in-flight turns (already-started dispatches keep running), drain,
             // and close.
             stopping = true;
+            // No new firings from here: the tick stops before anything drains,
+            // so the drain below is over a set that can only shrink. A tick
+            // already past its `stopping` check loses to `dispatch`'s own
+            // refusal — the second gate is why this needs no handshake.
+            scheduler.stop();
             // Deny what is parked before draining, or the drain waits out every
             // outstanding approval timeout — a shutdown would hang for as long as
             // the longest request had left. Each denial is a real decision the
@@ -1408,10 +1563,15 @@ export const createGateway = (options = {}) => {
             await Promise.allSettled(startedChannels.map((adapter) => adapter.stop()));
             startedChannels.length = 0;
             await Promise.allSettled([...inflight]);
+            // After the turn drain: a firing's wrapper settles after its
+            // dispatch does (it retires spent one-shots), so this is the last
+            // writer of the schedule table.
+            await scheduler.drain();
             // After the turns that might still be using them. A plugin holding a
             // browser is the reason this exists, and closing it out from under a
             // running screenshot would fail that turn rather than tidy up.
             await disposePlugins();
+            scheduleStore.close();
             store.close();
             log('stratusd stopped');
         },
@@ -1439,6 +1599,12 @@ export const createGateway = (options = {}) => {
                 .map((parked) => parked.pending)
                 .sort((a, b) => a.parkedAt.localeCompare(b.parkedAt));
         },
+        schedules() {
+            return scheduler.list();
+        },
+        cancelSchedule(scheduleId) {
+            return scheduler.cancel(scheduleId);
+        },
         tools() {
             // From the registry, not from the load records: the risk reported is
             // the one a call will actually be judged at, floor applied, and a
@@ -1454,6 +1620,32 @@ export const createGateway = (options = {}) => {
                 };
             });
         },
+        skills() {
+            // From the registry, not from the load records: the registry is the
+            // live answer for which bare aliases still resolve — a plugin loaded
+            // later can have retired one a record still remembers.
+            const provenance = new Map();
+            for (const info of operatorSkills) {
+                provenance.set(info.id, { path: info.path });
+            }
+            for (const plugin of loadedPlugins) {
+                for (const skill of plugin.skills) {
+                    provenance.set(skill.id, { package: plugin.package, path: skill.path });
+                }
+            }
+            return skillCatalog.list().map((skill) => {
+                const alias = skillCatalog.idsFor(skill.id).find((id) => id !== skill.id);
+                const from = provenance.get(skill.id);
+                return {
+                    id: skill.id,
+                    name: skill.name,
+                    description: skill.description,
+                    ...(alias !== undefined ? { alias } : {}),
+                    ...(from?.package !== undefined ? { package: from.package } : {}),
+                    ...(from !== undefined ? { path: from.path } : {}),
+                };
+            });
+        },
         plugins() {
             const loaded = loadedPlugins.map((plugin) => ({
                 package: plugin.package,
@@ -1466,6 +1658,20 @@ export const createGateway = (options = {}) => {
                     package: plugin.package,
                     trusted: plugin.trusted,
                 })),
+                // The alias comes from the live registry, exactly as `skills()`
+                // derives it: a plugin loaded later can have retired it, and this
+                // listing must not advertise a bare id `skill.read` would refuse.
+                skills: plugin.skills.map((skill) => {
+                    const alias = skillCatalog.idsFor(skill.id).find((id) => id !== skill.id);
+                    return {
+                        id: skill.id,
+                        name: skill.name,
+                        description: skill.description,
+                        ...(alias !== undefined ? { alias } : {}),
+                        package: plugin.package,
+                        path: skill.path,
+                    };
+                }),
             }));
             const failed = pluginFailures.map((failure) => ({
                 package: failure.package,