@nac3/forge-cli 0.2.0-alpha.8 → 0.2.1-alpha.60

package/dist/agents/store.js

@@ -0,0 +1,210 @@
+/**
+ * Local-mode agent storage (HITO 5 slice 1).
+ *
+ * Layout under `~/.yujin-forge/agents/`:
+ *
+ *   config.json                      -- user config overrides
+ *   by-slug/
+ *     <slug>/
+ *       definition.json              -- the AgentDefinition
+ *       runs/
+ *         <iso-ts>__<run_id>.json    -- one AgentRun per file
+ *   deleted/
+ *     <slug>__<iso-ts>/              -- moved here on delete + kept
+ *                                       agent.deletion.grace_period_days
+ *     ...
+ *
+ * Slice 1 ships the CRUD primitives + listing. Runner + bridge
+ * land in subsequent slices but consume the same store.
+ *
+ * Concurrency: each write is atomic (temp file + rename). Reads
+ * tolerate partial writes by skipping un-parseable files +
+ * logging.
+ */
+import { promises as fs } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { isValidAgentSlug, } from './types.js';
+function rootPath(opts = {}) {
+    return opts.root ?? path.join(os.homedir(), '.yujin-forge', 'agents');
+}
+function bySlugDir(opts = {}) {
+    return path.join(rootPath(opts), 'by-slug');
+}
+function deletedDir(opts = {}) {
+    return path.join(rootPath(opts), 'deleted');
+}
+function definitionPath(slug, opts = {}) {
+    return path.join(bySlugDir(opts), slug, 'definition.json');
+}
+function runsDir(slug, opts = {}) {
+    return path.join(bySlugDir(opts), slug, 'runs');
+}
+async function ensureDir(dir) {
+    await fs.mkdir(dir, { recursive: true });
+}
+/* Atomic write -- write to a sibling .tmp file, then rename. */
+async function writeJsonAtomic(p, obj) {
+    await ensureDir(path.dirname(p));
+    const tmp = p + '.tmp-' + process.pid + '-' + Date.now();
+    await fs.writeFile(tmp, JSON.stringify(obj, null, 2), 'utf-8');
+    await fs.rename(tmp, p);
+}
+async function readJson(p) {
+    try {
+        const raw = await fs.readFile(p, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/* ============================================================
+ * Definition CRUD
+ * ============================================================ */
+export async function listAgentSlugs(opts = {}) {
+    try {
+        const entries = await fs.readdir(bySlugDir(opts), { withFileTypes: true });
+        return entries
+            .filter((e) => e.isDirectory() && isValidAgentSlug(e.name))
+            .map((e) => e.name)
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+export async function getAgentDefinition(slug, opts = {}) {
+    if (!isValidAgentSlug(slug))
+        return null;
+    return readJson(definitionPath(slug, opts));
+}
+export async function listAgentDefinitions(opts = {}) {
+    const slugs = await listAgentSlugs(opts);
+    const out = [];
+    for (const slug of slugs) {
+        const def = await getAgentDefinition(slug, opts);
+        if (def)
+            out.push(def);
+    }
+    return out;
+}
+/** Create or overwrite an agent definition. Returns false if the
+ *  slug is invalid; throws if disk IO fails. */
+export async function saveAgentDefinition(def, opts = {}) {
+    if (!isValidAgentSlug(def.slug))
+        return false;
+    const existing = await getAgentDefinition(def.slug, opts);
+    const now = Date.now();
+    const merged = {
+        ...def,
+        created_at: existing?.created_at ?? def.created_at ?? now,
+        updated_at: now,
+    };
+    await writeJsonAtomic(definitionPath(def.slug, opts), merged);
+    return true;
+}
+/** Move an agent to the deletion grace partition. Runs travel
+ *  with it. Re-create + restore is a separate operation (TBD
+ *  in the deletion-undo slice). */
+export async function softDeleteAgent(slug, opts = {}) {
+    if (!isValidAgentSlug(slug))
+        return false;
+    const src = path.join(bySlugDir(opts), slug);
+    try {
+        await fs.access(src);
+    }
+    catch {
+        return false;
+    }
+    await ensureDir(deletedDir(opts));
+    const tombstone = path.join(deletedDir(opts), slug + '__' + new Date().toISOString().replace(/[:.]/g, '-'));
+    await fs.rename(src, tombstone);
+    return true;
+}
+/* ============================================================
+ * Run CRUD
+ * ============================================================ */
+/** Append a run record under the agent's runs/ dir. Run id is
+ *  generated if absent. */
+export async function appendAgentRun(slug, run, opts = {}) {
+    if (!isValidAgentSlug(slug)) {
+        throw new Error('appendAgentRun: invalid slug ' + JSON.stringify(slug));
+    }
+    const full = {
+        id: run.id ?? crypto.randomUUID(),
+        slug,
+        trigger_kind: run.trigger_kind,
+        trigger_reason: run.trigger_reason,
+        started_at: run.started_at,
+        ended_at: run.ended_at,
+        status: run.status,
+        tokens_in: run.tokens_in,
+        tokens_out: run.tokens_out,
+        tool_calls: run.tool_calls,
+        rejected_approvals: run.rejected_approvals,
+        last_reply_summary: run.last_reply_summary,
+        kill_reason: run.kill_reason,
+    };
+    const fname = new Date(full.started_at).toISOString().replace(/[:.]/g, '-') + '__' + full.id + '.json';
+    await writeJsonAtomic(path.join(runsDir(slug, opts), fname), full);
+    return full;
+}
+/** List runs for an agent, newest first. `limit` defaults to 50. */
+export async function listAgentRuns(slug, limit = 50, opts = {}) {
+    if (!isValidAgentSlug(slug))
+        return [];
+    const dir = runsDir(slug, opts);
+    let entries = [];
+    try {
+        entries = await fs.readdir(dir);
+    }
+    catch {
+        return [];
+    }
+    entries.sort((a, b) => b.localeCompare(a)); /* descending by ISO ts prefix */
+    const out = [];
+    for (const name of entries.slice(0, Math.max(0, limit))) {
+        const row = await readJson(path.join(dir, name));
+        if (row)
+            out.push(row);
+    }
+    return out;
+}
+/* ============================================================
+ * Utility
+ * ============================================================ */
+/** True iff `~/.yujin-forge/agents/` exists with at least one
+ *  agent. Used by `yf agent install --defaults` to decide whether
+ *  to seed. */
+export async function isStoreSeeded(opts = {}) {
+    const slugs = await listAgentSlugs(opts);
+    return slugs.length > 0;
+}
+/** Build a minimal AgentDefinition with sensible defaults. Used
+ *  by both `yf agent install --defaults` and tests. */
+export function buildAgentDefinitionDraft(slug, name, opts = {}) {
+    const now = Date.now();
+    return {
+        slug,
+        name,
+        description: opts.description ?? '',
+        brain_tier: opts.brain_tier ?? 'eco',
+        trigger: opts.trigger ?? { kind: 'manual', config: {} },
+        can_call: opts.can_call ?? [],
+        can_be_called_by: opts.can_be_called_by ?? [],
+        allowed_verbs: opts.allowed_verbs ?? [],
+        prompt_addition: opts.prompt_addition ?? '',
+        status: opts.status ?? 'active',
+        created_at: opts.created_at ?? now,
+        updated_at: opts.updated_at ?? now,
+        revoked_reason: opts.revoked_reason,
+    };
+}
+/** Filter an agent list by status (handy for `yf agent list
+ *  --status=active`). */
+export function filterByStatus(defs, status) {
+    return defs.filter((d) => d.status === status);
+}
+//# sourceMappingURL=store.js.map

package/dist/agents/store.js.map

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

package/dist/agents/system_prompt.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Agent system prompt builder (Director sprint slice 15a).
+ *
+ * Composes the effective system prompt for one agent run from:
+ *  - Identity: def.prompt_addition (role + role rules).
+ *  - Project context (root + name + version).
+ *  - Filtered graph snapshot (slice 11).
+ *  - Bridge protocol reminder.
+ *  - Doctrine pointers (testing-policy, language-sovereignty,
+ *    default-design-system, gates, pizarron, nac3-attrs,
+ *    mcp-bridge-lifecycle, byok-vs-managed).
+ *  - Allowed verbs (so the LLM does not invent).
+ *
+ * Pure function. The runner / chat builds the inputs (graph
+ * snapshot via filterSnapshotForRole, language_choices via
+ * workflow state) and calls us. We do NOT do I/O.
+ *
+ * ASCII-only.
+ */
+import type { AgentDefinition } from './types.js';
+export interface BuildOpts {
+    def: AgentDefinition;
+    project_root: string;
+    project_name: string;
+    forge_version: string;
+    /** Pre-rendered + per-role-filtered graph snapshot (see slice
+     *  11 filterSnapshotForRole). Empty string when worker is
+     *  unreachable or graph is empty -- the section is omitted. */
+    graph_snapshot_section?: string;
+    /** Pre-rendered workflow state section (PROJECT WORKFLOW STATE
+     *  block from workflow_inject.ts). Empty string when no
+     *  workflow yet. */
+    workflow_section?: string;
+}
+export declare function buildAgentSystemPrompt(opts: BuildOpts): string;
+//# sourceMappingURL=system_prompt.d.ts.map

package/dist/agents/system_prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system_prompt.d.ts","sourceRoot":"","sources":["../../src/agents/system_prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,WAAW,SAAS;IACxB,GAAG,EAAY,eAAe,CAAC;IAC/B,YAAY,EAAG,MAAM,CAAC;IACtB,YAAY,EAAG,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB;;mEAE+D;IAC/D,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC;;wBAEoB;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAwBD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAqF9D"}

package/dist/agents/system_prompt.js

@@ -0,0 +1,101 @@
+const DOCTRINE_POINTERS = [
+    '- testing-policy        (TDD-first scope + when to write red vs verify green)',
+    '- language-sovereignty  (user picks language; Director suggests, never imposes)',
+    '- default-design-system (Yujin DS as the default front-end; override via R8)',
+    '- workflow              (6 phases / 18 steps)',
+    '- gates                 (refuse-to-advance per phase)',
+    '- pizarron              (create-tab vs open-file; canvas vs editor)',
+    '- nac3-attrs            (data-nac-id / data-nac-role / data-nac-action)',
+    '- mcp-bridge-lifecycle  (when to discover, when to call, when to disable)',
+    '- byok-vs-managed       (per-tenant brain vs Yujin-managed brain)',
+    '- r8-modal              (destructive verbs always confirm)',
+];
+const BRIDGE_PROTOCOL = [
+    'INTER-AGENT BRIDGE protocol:',
+    '- You communicate with peer agents through the bridge (src/agents/bridge.ts).',
+    '- Every send is rate-limited by the pair token cap + loop detector.',
+    '- If a pair freezes (auto_revoked), report to the Director instead of retrying.',
+    '- Bridge payloads are JSON: { from_slug, to_slug, payload, tokens_used }.',
+    '- The receiver drains its inbox at the next tick; do NOT block waiting.',
+];
+export function buildAgentSystemPrompt(opts) {
+    const def = opts.def;
+    const parts = [];
+    /* Header block: role metadata. */
+    parts.push('=================================================================');
+    parts.push('ROLE:        ' + def.slug);
+    parts.push('NAME:        ' + def.name);
+    parts.push('BRAIN TIER:  ' + def.brain_tier);
+    parts.push('STATUS:      ' + def.status);
+    parts.push('TRIGGER:     ' + def.trigger.kind);
+    parts.push('=================================================================');
+    parts.push('');
+    /* Identity + role rules from the def. */
+    parts.push(def.prompt_addition);
+    parts.push('');
+    /* Project context. */
+    parts.push('=================================================================');
+    parts.push('CONTEXT (this project)');
+    parts.push('=================================================================');
+    parts.push('');
+    parts.push('- Project: ' + opts.project_name);
+    parts.push('- Root:    ' + opts.project_root);
+    parts.push('- Forge:   ' + opts.forge_version);
+    parts.push('');
+    /* Bridge protocol (relevant when can_call OR can_be_called_by
+     * is non-empty -- almost always, but still gated for clarity). */
+    if ((def.can_call && def.can_call.length > 0) || (def.can_be_called_by && def.can_be_called_by.length > 0)) {
+        parts.push('=================================================================');
+        parts.push('BRIDGE PROTOCOL');
+        parts.push('=================================================================');
+        parts.push('');
+        parts.push(...BRIDGE_PROTOCOL);
+        parts.push('');
+        if (def.can_call && def.can_call.length > 0) {
+            parts.push('You can call: [' + def.can_call.join(', ') + ']');
+        }
+        if (def.can_be_called_by && def.can_be_called_by.length > 0) {
+            parts.push('You accept inbound from: [' + def.can_be_called_by.join(', ') + ']');
+        }
+        parts.push('');
+    }
+    /* Allowed verbs -- the LLM does NOT invent verb names. */
+    parts.push('=================================================================');
+    parts.push('ALLOWED VERBS (yujin.* you are permitted to invoke)');
+    parts.push('=================================================================');
+    parts.push('');
+    if (def.allowed_verbs && def.allowed_verbs.length > 0) {
+        for (const v of def.allowed_verbs)
+            parts.push('- ' + v);
+    }
+    else {
+        parts.push('(no verbs declared; the runner will reject any tool call)');
+    }
+    parts.push('');
+    /* Doctrine pointers (on-demand fetch). */
+    parts.push('=================================================================');
+    parts.push('DOCTRINE POINTERS (on-demand)');
+    parts.push('=================================================================');
+    parts.push('');
+    parts.push('Fetch a full doctrine via yujin.doctrine.discover({slugs: [...]}):');
+    parts.push('');
+    for (const p of DOCTRINE_POINTERS)
+        parts.push(p);
+    parts.push('');
+    /* Optional graph snapshot section. */
+    if (opts.graph_snapshot_section && opts.graph_snapshot_section.trim().length > 0) {
+        parts.push('=================================================================');
+        parts.push('PROJECT GRAPH (this turn -- the panoramic structural view)');
+        parts.push('=================================================================');
+        parts.push('');
+        parts.push(opts.graph_snapshot_section);
+        parts.push('');
+    }
+    /* Optional workflow state section. */
+    if (opts.workflow_section && opts.workflow_section.trim().length > 0) {
+        parts.push(opts.workflow_section);
+        parts.push('');
+    }
+    return parts.join('\n');
+}
+//# sourceMappingURL=system_prompt.js.map

package/dist/agents/system_prompt.js.map

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

package/dist/agents/types.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Shared types for the HITO 5 agent orchestrator (slice 1+).
+ *
+ * AgentDefinition: the persistent agent config the user authors.
+ * AgentRun: a single execution attempt, with status + telemetry.
+ * AgentMessage: an inter-agent bridge message (D1 storage in
+ *               managed mode, JSON buffer in local-only mode).
+ *
+ * Per HITO 5 lock 2026-06-04: every numeric threshold this module
+ * touches comes from `getAgentConfig(key)` in config_resolver.ts,
+ * not from a literal here.
+ */
+/** Trigger kinds an agent can subscribe to. */
+export type AgentTriggerKind = 'manual' | 'cron' | 'event';
+export interface AgentTrigger {
+    kind: AgentTriggerKind;
+    /** Trigger-kind-specific config. Shape depends on kind:
+     *   manual -> {}
+     *   cron   -> { cron_expr: string }
+     *   event  -> { match: string }   // e.g. "pipeline_runs:advance_stage"
+     */
+    config: Record<string, unknown>;
+}
+/** Status field on an AgentDefinition. */
+export type AgentDefinitionStatus = 'active' | 'paused' | 'deleted' | 'auto_revoked';
+export interface AgentDefinition {
+    /** Stable slug (kebab-case). Used as bridge address + filesystem key. */
+    slug: string;
+    /** Display name (free text). */
+    name: string;
+    /** One-liner shown in `yf agent list`. */
+    description: string;
+    /** Brain tier the agent runs on. */
+    brain_tier: 'eco' | 'frontier' | 'managed';
+    /** When/how the agent fires. */
+    trigger: AgentTrigger;
+    /** Whitelist of agent slugs THIS agent is allowed to message via
+     *  the bridge. Receivers in `can_call` must ALSO whitelist back
+     *  -- handshake is two-sided. */
+    can_call: string[];
+    /** Whitelist of agent slugs that may message THIS agent. */
+    can_be_called_by: string[];
+    /** NAC-3 verbs the agent is allowed to invoke. Restricts the
+     *  manifest the brain sees during the run. Empty = inherit from
+     *  the user's full manifest (rare; usually a narrow list). */
+    allowed_verbs: string[];
+    /** System prompt addition. Appended to the default agent system
+     *  prompt -- NOT a replacement. */
+    prompt_addition: string;
+    /** Lifecycle state. */
+    status: AgentDefinitionStatus;
+    created_at: number;
+    updated_at: number;
+    /** When set, agent moved here from `active` -- `auto_revoked` */
+    revoked_reason?: string;
+}
+/** Outcome of an AgentRun. */
+export type AgentRunStatus = 'queued' | 'running' | 'succeeded' | 'failed' | 'timeout' | 'killed_quota' | 'killed_rejections' | 'killed_user' | 'paused_for_approval';
+export interface AgentRun {
+    id: string;
+    slug: string;
+    trigger_kind: AgentTriggerKind;
+    /** Free-text reason the run started (e.g. "manual", "cron tick
+     *  at 06:00 UTC", "event:pipeline_runs:advance_stage"). */
+    trigger_reason: string;
+    started_at: number;
+    ended_at?: number;
+    status: AgentRunStatus;
+    /** Telemetry. */
+    tokens_in: number;
+    tokens_out: number;
+    tool_calls: number;
+    rejected_approvals: number;
+    /** Last brain reply text (truncated to first 500 chars for the
+     *  list view). Full transcript in the run's transcript file. */
+    last_reply_summary: string;
+    /** When status is a kill code, the reason in plain text. */
+    kill_reason?: string;
+    /** Slice 1 of N-projects sprint -- project the run belongs to.
+     *  Defaults to 'self' (single-project mode = legacy behaviour).
+     *  Lets the Activity panel + SVG + bridge inspector filter by
+     *  project; lets semaphores cap concurrent runs per project. */
+    project_slug?: string;
+}
+/** Status of a single inter-agent message. */
+export type AgentMessageStatus = 'pending' | 'delivered' | 'read' | 'expired' | 'auto_revoked';
+export interface AgentMessage {
+    id: number;
+    /** sha256 of `min(a,b) + "|" + max(a,b)` -- deterministic pair id
+     *  so loop detection works regardless of direction. */
+    pair_id: string;
+    from_slug: string;
+    to_slug: string;
+    /** Free-shape payload (sender supplies). */
+    payload: unknown;
+    /** Tokens this message cost (counts against the pair quota). */
+    tokens_used: number;
+    status: AgentMessageStatus;
+    created_at: number;
+    delivered_at?: number;
+    read_at?: number;
+    /** TTL in epoch ms. Default = created_at + agent.bridge.message_ttl_seconds. */
+    expires_at: number;
+    /** Slice 1 of N-projects sprint -- project the message belongs
+     *  to. Mirrors AgentRun.project_slug; defaults to 'self'. Drives
+     *  bridge file sharding (`bridge-{project_slug}.json`) so two
+     *  projects can swap messages without contending on a single
+     *  global JSON. */
+    project_slug?: string;
+}
+/** Pair-level state tracked by the bridge for cap enforcement +
+ *  loop detection. Stored alongside agent_messages. */
+export interface AgentPairCap {
+    pair_id: string;
+    tokens_used_window: number;
+    window_started_at: number;
+    round_trips_60s: number;
+    last_round_trip_at: number;
+    status: 'open' | 'frozen' | 'auto_revoked';
+}
+export declare function pairIdFor(a: string, b: string): string;
+export declare function isValidAgentSlug(slug: unknown): slug is string;
+//# sourceMappingURL=types.d.ts.map

package/dist/agents/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,+CAA+C;AAC/C,MAAM,MAAM,gBAAgB,GACxB,QAAQ,GACR,MAAM,GACN,OAAO,CAAC;AAEZ,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAI,gBAAgB,CAAC;IACzB;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,0CAA0C;AAC1C,MAAM,MAAM,qBAAqB,GAC7B,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,cAAc,CAAC;AAEnB,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,UAAU,EAAE,KAAK,GAAG,UAAU,GAAG,SAAS,CAAC;IAC3C,gCAAgC;IAChC,OAAO,EAAE,YAAY,CAAC;IACtB;;qCAEiC;IACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,4DAA4D;IAC5D,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B;;kEAE8D;IAC9D,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB;uCACmC;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,uBAAuB;IACvB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,8BAA8B;AAC9B,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,SAAS,GACT,WAAW,GACX,QAAQ,GACR,SAAS,GACT,cAAc,GACd,mBAAmB,GACnB,aAAa,GACb,qBAAqB,CAAC;AAM1B,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,gBAAgB,CAAC;IAC/B;+DAC2D;IAC3D,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,cAAc,CAAC;IACvB,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B;oEACgE;IAChE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;oEAGgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,8CAA8C;AAC9C,MAAM,MAAM,kBAAkB,GAC1B,SAAS,GACT,WAAW,GACX,MAAM,GACN,SAAS,GACT,cAAc,CAAC;AAEnB,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX;2DACuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,UAAU,EAAE,MAAM,CAAC;IACnB;;;;uBAImB;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;uDACuD;AACvD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,cAAc,CAAC;CAC5C;AAID,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAatD;AAKD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,MAAM,CAI9D"}

package/dist/agents/types.js

@@ -0,0 +1,39 @@
+/**
+ * Shared types for the HITO 5 agent orchestrator (slice 1+).
+ *
+ * AgentDefinition: the persistent agent config the user authors.
+ * AgentRun: a single execution attempt, with status + telemetry.
+ * AgentMessage: an inter-agent bridge message (D1 storage in
+ *               managed mode, JSON buffer in local-only mode).
+ *
+ * Per HITO 5 lock 2026-06-04: every numeric threshold this module
+ * touches comes from `getAgentConfig(key)` in config_resolver.ts,
+ * not from a literal here.
+ */
+/* Helper: deterministic pair id used by the bridge. Pure function
+ * so both ends derive the same id without coordination. */
+export function pairIdFor(a, b) {
+    const lo = a < b ? a : b;
+    const hi = a < b ? b : a;
+    /* Tiny FNV-1a -- no crypto dep needed, just a stable hash for
+     *  use as a primary key. Collision risk is irrelevant: the input
+     *  space is "your own agent slugs", a few hundred at most. */
+    let h = 0x811c9dc5;
+    const s = lo + '|' + hi;
+    for (let i = 0; i < s.length; i++) {
+        h ^= s.charCodeAt(i);
+        h = Math.imul(h, 0x01000193);
+    }
+    return ('00000000' + (h >>> 0).toString(16)).slice(-8);
+}
+/* Slug validation -- agent slugs follow the same kebab-case rules
+ * as pipeline slugs in the parent CRM repo. Re-implemented here
+ * so the agents module has no cross-module import. */
+export function isValidAgentSlug(slug) {
+    if (typeof slug !== 'string')
+        return false;
+    if (slug.length < 2 || slug.length > 80)
+        return false;
+    return /^[a-z][a-z0-9-]*[a-z0-9]$/.test(slug);
+}
+//# sourceMappingURL=types.js.map

package/dist/agents/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAgJH;2DAC2D;AAC3D,MAAM,UAAU,SAAS,CAAC,CAAS,EAAE,CAAS;IAC5C,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzB;;kEAE8D;IAC9D,IAAI,CAAC,GAAG,UAAU,CAAC;IACnB,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,EAAE,CAAC;IACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACrB,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,CAAC,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACzD,CAAC;AAED;;sDAEsD;AACtD,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC3C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,KAAK,CAAC;IACtD,OAAO,2BAA2B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChD,CAAC"}

package/dist/bin/yf.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"yf.d.ts","sourceRoot":"","sources":["../../src/bin/yf.ts"],"names":[],"mappings":";AAUA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4BpC,wBAAgB,YAAY,IAAI,OAAO,CAsCtC"}
+{"version":3,"file":"yf.d.ts","sourceRoot":"","sources":["../../src/bin/yf.ts"],"names":[],"mappings":";AAUA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8DpC,wBAAgB,YAAY,IAAI,OAAO,CAqFtC"}