@bradygaster/squad-sdk 0.9.0 → 0.9.2-insider.1

package/dist/state/handles.js

@@ -0,0 +1,161 @@
+/**
+ * State Module — Agent Handle Implementation
+ *
+ * Concrete implementation of the `AgentHandle` interface from collection-map.ts.
+ * Wires up to StorageProvider + IO layer for reading/writing agent state.
+ *
+ * @module state/handles
+ */
+import { parseHistory, serializeHistoryAppend } from './io/history-io.js';
+import { parseTeam, serializeTeam } from './io/team-io.js';
+import { NotFoundError, ParseError } from './domain-types.js';
+import { resolveCollectionPath } from './schema.js';
+// ── History Section Mapping ────────────────────────────────────────────────
+const SECTION_KEYS = [
+    { section: 'Context', key: 'context' },
+    { section: 'Learnings', key: 'learnings' },
+    { section: 'Decisions', key: 'decisions' },
+    { section: 'Patterns', key: 'patterns' },
+    { section: 'Issues', key: 'issues' },
+    { section: 'References', key: 'references' },
+];
+/**
+ * Convert a ParsedHistory into an array of HistoryEntry objects.
+ *
+ * Splits each section's content by `### date/title` sub-headers into
+ * individual entries with extracted timestamps.
+ */
+function parsedHistoryToEntries(parsed, filterSection) {
+    const entries = [];
+    const sections = filterSection
+        ? SECTION_KEYS.filter((s) => s.section === filterSection)
+        : SECTION_KEYS;
+    for (const { section, key } of sections) {
+        const content = parsed[key];
+        if (!content)
+            continue;
+        const subHeaderRegex = /^###\s+(.+)$/gm;
+        const subHeaders = [];
+        let m;
+        while ((m = subHeaderRegex.exec(content)) !== null) {
+            subHeaders.push({
+                title: m[1],
+                start: m.index,
+                contentStart: m.index + m[0].length,
+            });
+        }
+        if (subHeaders.length === 0) {
+            entries.push({ section, content: content.trim(), timestamp: '' });
+        }
+        else {
+            for (let i = 0; i < subHeaders.length; i++) {
+                const hdr = subHeaders[i];
+                const nextHdr = subHeaders[i + 1];
+                const start = hdr.contentStart;
+                const end = nextHdr ? nextHdr.start : content.length;
+                const entryContent = content.substring(start, end).trim();
+                const dateMatch = hdr.title.match(/(\d{4}-\d{2}-\d{2})/);
+                const timestamp = dateMatch?.[1] ?? '';
+                entries.push({ section, content: entryContent, timestamp });
+            }
+        }
+    }
+    return entries;
+}
+// ── Factory ────────────────────────────────────────────────────────────────
+/**
+ * Create a concrete AgentHandle bound to a specific agent, storage provider,
+ * and root directory.
+ */
+export function createAgentHandle(name, storage, rootDir) {
+    const agentDir = `${rootDir}/.squad/agents/${name}`;
+    const charterPath = `${agentDir}/charter.md`;
+    const historyPath = `${agentDir}/history.md`;
+    const teamPath = `${rootDir}/${resolveCollectionPath('team')}`;
+    const handle = {
+        name,
+        async charter() {
+            const content = await storage.read(charterPath);
+            if (content === undefined) {
+                throw new NotFoundError('agents', name);
+            }
+            return content;
+        },
+        history(section) {
+            return (async () => {
+                const content = await storage.read(historyPath);
+                if (content === undefined) {
+                    return [];
+                }
+                let parsed;
+                try {
+                    parsed = parseHistory(content);
+                }
+                catch (err) {
+                    throw new ParseError('history', err instanceof Error ? err.message : String(err), { cause: err });
+                }
+                return parsedHistoryToEntries(parsed, section);
+            })();
+        },
+        async appendHistory(section, entry) {
+            const content = await storage.read(historyPath);
+            const fragment = serializeHistoryAppend(section, entry.content, entry.timestamp || undefined);
+            if (content === undefined) {
+                const newContent = `# ${name}\n\n## ${section}\n\n${fragment}`;
+                await storage.write(historyPath, newContent);
+                return;
+            }
+            const sectionRegex = new RegExp(`^## ${section}\\s*$`, 'm');
+            const sectionMatch = sectionRegex.exec(content);
+            if (sectionMatch) {
+                // Find next ## header after this section to determine insertion point
+                const afterHeader = sectionMatch.index + sectionMatch[0].length;
+                const rest = content.substring(afterHeader);
+                const nextSectionMatch = /^## /m.exec(rest.length > 1 ? rest.substring(1) : '');
+                const insertPos = nextSectionMatch
+                    ? afterHeader + 1 + nextSectionMatch.index
+                    : content.length;
+                const before = content.substring(0, insertPos).trimEnd();
+                const after = content.substring(insertPos);
+                const newContent = before + '\n\n' + fragment + (after.trim() ? '\n' + after.trimStart() : '');
+                await storage.write(historyPath, newContent.trimEnd() + '\n');
+            }
+            else {
+                // Section doesn't exist yet — append at end
+                const newContent = content.trimEnd() + `\n\n## ${section}\n\n${fragment}`;
+                await storage.write(historyPath, newContent.trimEnd() + '\n');
+            }
+        },
+        async update(updates) {
+            const teamContent = await storage.read(teamPath);
+            if (teamContent === undefined) {
+                throw new NotFoundError('team');
+            }
+            let agents;
+            try {
+                agents = parseTeam(teamContent).agents;
+            }
+            catch (err) {
+                throw new ParseError('team', err instanceof Error ? err.message : String(err), { cause: err });
+            }
+            const lowerName = name.toLowerCase();
+            const idx = agents.findIndex((a) => a.name.toLowerCase() === lowerName);
+            if (idx === -1) {
+                throw new NotFoundError('agents', name);
+            }
+            const current = agents[idx];
+            const updated = {
+                name: updates.name ?? current.name,
+                role: updates.role ?? current.role,
+                skills: updates.skills ? [...updates.skills] : current.skills,
+                model: updates.modelPreference ?? current.model,
+                status: updates.status !== undefined ? String(updates.status) : current.status,
+            };
+            agents[idx] = updated;
+            const serialized = serializeTeam(agents);
+            await storage.write(teamPath, serialized);
+        },
+    };
+    return handle;
+}
+//# sourceMappingURL=handles.js.map

package/dist/state/handles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handles.js","sourceRoot":"","sources":["../../src/state/handles.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD,8EAA8E;AAE9E,MAAM,YAAY,GAAiE;IACjF,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE;IACtC,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,EAAE;IAC1C,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,EAAE;IAC1C,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,EAAE;IACxC,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE;IACpC,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,YAAY,EAAE;CAC7C,CAAC;AAEF;;;;;GAKG;AACH,SAAS,sBAAsB,CAC7B,MAAqB,EACrB,aAA8B;IAE9B,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,MAAM,QAAQ,GAAG,aAAa;QAC5B,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,aAAa,CAAC;QACzD,CAAC,CAAC,YAAY,CAAC;IAEjB,KAAK,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,QAAQ,EAAE,CAAC;QACxC,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAuB,CAAC;QAClD,IAAI,CAAC,OAAO;YAAE,SAAS;QAEvB,MAAM,cAAc,GAAG,gBAAgB,CAAC;QACxC,MAAM,UAAU,GAAkE,EAAE,CAAC;QACrF,IAAI,CAAyB,CAAC;QAC9B,OAAO,CAAC,CAAC,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACnD,UAAU,CAAC,IAAI,CAAC;gBACd,KAAK,EAAE,CAAC,CAAC,CAAC,CAAE;gBACZ,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,YAAY,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM;aACpC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;QACpE,CAAC;aAAM,CAAC;YACN,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC3C,MAAM,GAAG,GAAG,UAAU,CAAC,CAAC,CAAE,CAAC;gBAC3B,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBAClC,MAAM,KAAK,GAAG,GAAG,CAAC,YAAY,CAAC;gBAC/B,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;gBACrD,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC1D,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;gBACzD,MAAM,SAAS,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;gBACvC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAY,EACZ,OAAwB,EACxB,OAAe;IAEf,MAAM,QAAQ,GAAG,GAAG,OAAO,kBAAkB,IAAI,EAAE,CAAC;IACpD,MAAM,WAAW,GAAG,GAAG,QAAQ,aAAa,CAAC;IAC7C,MAAM,WAAW,GAAG,GAAG,QAAQ,aAAa,CAAC;IAC7C,MAAM,QAAQ,GAAG,GAAG,OAAO,IAAI,qBAAqB,CAAC,MAAM,CAAC,EAAE,CAAC;IAE/D,MAAM,MAAM,GAAgB;QAC1B,IAAI;QAEJ,KAAK,CAAC,OAAO;YACX,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAChD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC1B,MAAM,IAAI,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YAC1C,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,OAAO,CAAC,OAAwB;YAC9B,OAAO,CAAC,KAAK,IAAI,EAAE;gBACjB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;gBAChD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;oBAC1B,OAAO,EAAE,CAAC;gBACZ,CAAC;gBACD,IAAI,MAAM,CAAC;gBACX,IAAI,CAAC;oBACH,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;gBACjC,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,IAAI,UAAU,CAAC,SAAS,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;gBACpG,CAAC;gBACD,OAAO,sBAAsB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACjD,CAAC,CAAC,EAAE,CAAC;QACP,CAAC;QAED,KAAK,CAAC,aAAa,CAAC,OAAuB,EAAE,KAAmB;YAC9D,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAChD,MAAM,QAAQ,GAAG,sBAAsB,CACrC,OAAO,EACP,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,SAAS,IAAI,SAAS,CAC7B,CAAC;YAEF,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC1B,MAAM,UAAU,GAAG,KAAK,IAAI,UAAU,OAAO,OAAO,QAAQ,EAAE,CAAC;gBAC/D,MAAM,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;gBAC7C,OAAO;YACT,CAAC;YAED,MAAM,YAAY,GAAG,IAAI,MAAM,CAAC,OAAO,OAAO,OAAO,EAAE,GAAG,CAAC,CAAC;YAC5D,MAAM,YAAY,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAEhD,IAAI,YAAY,EAAE,CAAC;gBACjB,sEAAsE;gBACtE,MAAM,WAAW,GAAG,YAAY,CAAC,KAAK,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;gBAChE,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;gBAC5C,MAAM,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAEhF,MAAM,SAAS,GAAG,gBAAgB;oBAChC,CAAC,CAAC,WAAW,GAAG,CAAC,GAAG,gBAAgB,CAAC,KAAK;oBAC1C,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;gBAEnB,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;gBACzD,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;gBAC3C,MAAM,UAAU,GACd,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC9E,MAAM,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,UAAU,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;YAChE,CAAC;iBAAM,CAAC;gBACN,4CAA4C;gBAC5C,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,EAAE,GAAG,UAAU,OAAO,OAAO,QAAQ,EAAE,CAAC;gBAC1E,MAAM,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,UAAU,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,OAAuB;YAClC,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACjD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;gBAC9B,MAAM,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;YAClC,CAAC;YAED,IAAI,MAAM,CAAC;YACX,IAAI,CAAC;gBACH,MAAM,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC;YACzC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,IAAI,UAAU,CAAC,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YACjG,CAAC;YACD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YACrC,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,SAAS,CAAC,CAAC;YACxE,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;gBACf,MAAM,IAAI,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YAC1C,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAE,CAAC;YAC7B,MAAM,OAAO,GAAG;gBACd,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI;gBAClC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI;gBAClC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM;gBAC7D,KAAK,EAAE,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC,KAAK;gBAC/C,MAAM,EAAE,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM;aAC/E,CAAC;YACF,MAAM,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC;YAEtB,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;YACzC,MAAM,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAC5C,CAAC;KACF,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/state/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * State Module — Barrel Export
+ *
+ * Phase 2 of StorageProvider PRD (#481).
+ * Typed facade layer over `.squad/` file-based state.
+ */
+export type { Agent, Decision, HistoryEntry, HistorySection, LogEntry, ModelTier, RoutingConfig, RoutingConfigRule, RoutingRule, SkillDefinition, SquadStateConfig, StateErrorKind, StorageProvider, TeamConfig, TeamMember, Template, WorkType, } from './domain-types.js';
+export type { AgentStatus } from './domain-types.js';
+export { StateError, NotFoundError, ParseError, WriteConflictError, ProviderError, } from './domain-types.js';
+export type { CollectionEntityMap, CollectionName, AgentHandle, } from './collection-map.js';
+export type { CollectionPathResolver } from './schema.js';
+export { COLLECTION_PATHS, resolveCollectionPath } from './schema.js';
+export { createAgentHandle } from './handles.js';
+export { AgentsCollection, ConfigCollection, DecisionsCollection, LogCollection, RoutingCollection, SkillsCollection, TeamCollection, TemplatesCollection, } from './collections.js';
+export type { ConfigFileData } from './collections.js';
+export { SquadState } from './squad-state.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/state/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,KAAK,EACL,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,QAAQ,EACR,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,UAAU,EACV,UAAU,EACV,QAAQ,EACR,QAAQ,GACT,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EACL,UAAU,EACV,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGjD,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGvD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/state/index.js

@@ -0,0 +1,15 @@
+/**
+ * State Module — Barrel Export
+ *
+ * Phase 2 of StorageProvider PRD (#481).
+ * Typed facade layer over `.squad/` file-based state.
+ */
+export { StateError, NotFoundError, ParseError, WriteConflictError, ProviderError, } from './domain-types.js';
+export { COLLECTION_PATHS, resolveCollectionPath } from './schema.js';
+// Agent handle factory
+export { createAgentHandle } from './handles.js';
+// Collection facades
+export { AgentsCollection, ConfigCollection, DecisionsCollection, LogCollection, RoutingCollection, SkillsCollection, TeamCollection, TemplatesCollection, } from './collections.js';
+// SquadState facade
+export { SquadState } from './squad-state.js';
+//# sourceMappingURL=index.js.map

package/dist/state/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyBH,OAAO,EACL,UAAU,EACV,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAW3B,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEtE,uBAAuB;AACvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,qBAAqB;AACrB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAI1B,oBAAoB;AACpB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/state/io/charter-io.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Charter Markdown I/O — parse and serialize charter.md files.
+ *
+ * Wraps the existing `parseCharterMarkdown()` from charter-compiler.ts
+ * and adds serialization for round-trip support.
+ *
+ * @module state/io/charter-io
+ */
+import { type ParsedCharter } from '../../agents/charter-compiler.js';
+export type { ParsedCharter };
+/**
+ * Parse charter markdown into a typed structure.
+ * Delegates to the existing `parseCharterMarkdown()`.
+ */
+export declare function parseCharter(markdown: string): ParsedCharter;
+/**
+ * Serialize a ParsedCharter back to markdown.
+ *
+ * Produces the canonical charter.md format:
+ * ```
+ * # {Name} — {Role}
+ * > {style quote}
+ * ## Identity
+ * ...
+ * ```
+ */
+export declare function serializeCharter(charter: ParsedCharter): string;
+//# sourceMappingURL=charter-io.d.ts.map

package/dist/state/io/charter-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"charter-io.d.ts","sourceRoot":"","sources":["../../../src/state/io/charter-io.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAE5F,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAE5D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAyE/D"}

package/dist/state/io/charter-io.js

@@ -0,0 +1,94 @@
+/**
+ * Charter Markdown I/O — parse and serialize charter.md files.
+ *
+ * Wraps the existing `parseCharterMarkdown()` from charter-compiler.ts
+ * and adds serialization for round-trip support.
+ *
+ * @module state/io/charter-io
+ */
+import { parseCharterMarkdown } from '../../agents/charter-compiler.js';
+/**
+ * Parse charter markdown into a typed structure.
+ * Delegates to the existing `parseCharterMarkdown()`.
+ */
+export function parseCharter(markdown) {
+    return parseCharterMarkdown(markdown);
+}
+/**
+ * Serialize a ParsedCharter back to markdown.
+ *
+ * Produces the canonical charter.md format:
+ * ```
+ * # {Name} — {Role}
+ * > {style quote}
+ * ## Identity
+ * ...
+ * ```
+ */
+export function serializeCharter(charter) {
+    const lines = [];
+    // Title line
+    const name = charter.identity.name ?? 'Agent';
+    const role = charter.identity.role ?? 'Developer';
+    lines.push(`# ${name} — ${role}`);
+    lines.push('');
+    // Style quote
+    if (charter.identity.style) {
+        lines.push(`> ${charter.identity.style}`);
+        lines.push('');
+    }
+    // Identity section
+    lines.push('## Identity');
+    lines.push('');
+    if (charter.identity.name) {
+        lines.push(`- **Name:** ${charter.identity.name}`);
+    }
+    if (charter.identity.role) {
+        lines.push(`- **Role:** ${charter.identity.role}`);
+    }
+    if (charter.identity.expertise && charter.identity.expertise.length > 0) {
+        lines.push(`- **Expertise:** ${charter.identity.expertise.join(', ')}`);
+    }
+    if (charter.identity.style) {
+        lines.push(`- **Style:** ${charter.identity.style}`);
+    }
+    lines.push('');
+    // What I Own section
+    if (charter.ownership !== undefined) {
+        lines.push('## What I Own');
+        lines.push('');
+        lines.push(charter.ownership);
+        lines.push('');
+    }
+    // Boundaries section
+    if (charter.boundaries !== undefined) {
+        lines.push('## Boundaries');
+        lines.push('');
+        lines.push(charter.boundaries);
+        lines.push('');
+    }
+    // Model section
+    if (charter.modelPreference || charter.modelRationale || charter.modelFallback) {
+        lines.push('## Model');
+        lines.push('');
+        if (charter.modelPreference) {
+            lines.push(`**Preferred:** ${charter.modelPreference}`);
+        }
+        if (charter.modelRationale) {
+            lines.push(`**Rationale:** ${charter.modelRationale}`);
+        }
+        if (charter.modelFallback) {
+            lines.push(`**Fallback:** ${charter.modelFallback}`);
+        }
+        lines.push('');
+    }
+    // Collaboration section
+    if (charter.collaboration !== undefined) {
+        lines.push('## Collaboration');
+        lines.push('');
+        lines.push(charter.collaboration);
+        lines.push('');
+    }
+    return lines.join('\n').trimEnd() + '\n';
+}
+//# sourceMappingURL=charter-io.js.map

package/dist/state/io/charter-io.js.map

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

package/dist/state/io/decisions-io.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Decisions Markdown I/O — parse and serialize decisions.md files.
+ *
+ * Wraps the existing `parseDecisionsMarkdown()` from markdown-migration.ts
+ * and adds serialization for round-trip support.
+ *
+ * @module state/io/decisions-io
+ */
+import { type ParsedDecision } from '../../config/markdown-migration.js';
+export type { ParsedDecision };
+/**
+ * Parse decisions markdown into typed decision entries.
+ * Delegates to the existing `parseDecisionsMarkdown()`.
+ */
+export declare function parseDecisions(markdown: string): ParsedDecision[];
+/**
+ * Serialize a single decision entry to markdown.
+ *
+ * Format:
+ * ```
+ * ### YYYY-MM-DD: Title
+ * **By:** author
+ * body content
+ * ```
+ */
+export declare function serializeDecision(decision: ParsedDecision): string;
+/**
+ * Serialize an array of decisions to a full decisions.md file.
+ *
+ * Produces:
+ * ```
+ * # Decisions
+ *
+ * ### 2026-01-15: First Decision
+ * ...
+ *
+ * ### 2026-02-01: Second Decision
+ * ...
+ * ```
+ */
+export declare function serializeDecisions(decisions: ParsedDecision[]): string;
+//# sourceMappingURL=decisions-io.d.ts.map

package/dist/state/io/decisions-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisions-io.d.ts","sourceRoot":"","sources":["../../../src/state/io/decisions-io.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEjG,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE,CAGjE;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAmBlE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,MAAM,CAMtE"}

package/dist/state/io/decisions-io.js

@@ -0,0 +1,66 @@
+/**
+ * Decisions Markdown I/O — parse and serialize decisions.md files.
+ *
+ * Wraps the existing `parseDecisionsMarkdown()` from markdown-migration.ts
+ * and adds serialization for round-trip support.
+ *
+ * @module state/io/decisions-io
+ */
+import { parseDecisionsMarkdown } from '../../config/markdown-migration.js';
+/**
+ * Parse decisions markdown into typed decision entries.
+ * Delegates to the existing `parseDecisionsMarkdown()`.
+ */
+export function parseDecisions(markdown) {
+    const { decisions } = parseDecisionsMarkdown(markdown);
+    return decisions;
+}
+/**
+ * Serialize a single decision entry to markdown.
+ *
+ * Format:
+ * ```
+ * ### YYYY-MM-DD: Title
+ * **By:** author
+ * body content
+ * ```
+ */
+export function serializeDecision(decision) {
+    const level = decision.headingLevel ?? 3;
+    const hashes = '#'.repeat(level);
+    // Heading with optional date prefix
+    const datePrefix = decision.date ? `${decision.date}: ` : '';
+    const lines = [`${hashes} ${datePrefix}${decision.title}`];
+    // Body — author line is already embedded in body from the parser,
+    // but if body doesn't contain **By:** and author is set, prepend it
+    const bodyHasAuthor = /\*\*By:\*\*/i.test(decision.body);
+    if (decision.author && !bodyHasAuthor) {
+        lines.push(`**By:** ${decision.author}`);
+    }
+    if (decision.body) {
+        lines.push(decision.body);
+    }
+    return lines.join('\n');
+}
+/**
+ * Serialize an array of decisions to a full decisions.md file.
+ *
+ * Produces:
+ * ```
+ * # Decisions
+ *
+ * ### 2026-01-15: First Decision
+ * ...
+ *
+ * ### 2026-02-01: Second Decision
+ * ...
+ * ```
+ */
+export function serializeDecisions(decisions) {
+    if (decisions.length === 0) {
+        return '# Decisions\n';
+    }
+    const sections = decisions.map((d) => serializeDecision(d));
+    return `# Decisions\n\n${sections.join('\n\n')}\n`;
+}
+//# sourceMappingURL=decisions-io.js.map

package/dist/state/io/decisions-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisions-io.js","sourceRoot":"","sources":["../../../src/state/io/decisions-io.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,sBAAsB,EAAuB,MAAM,oCAAoC,CAAC;AAIjG;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,MAAM,EAAE,SAAS,EAAE,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IACvD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAwB;IACxD,MAAM,KAAK,GAAG,QAAQ,CAAC,YAAY,IAAI,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEjC,oCAAoC;IACpC,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,MAAM,KAAK,GAAa,CAAC,GAAG,MAAM,IAAI,UAAU,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAErE,kEAAkE;IAClE,oEAAoE;IACpE,MAAM,aAAa,GAAG,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,QAAQ,CAAC,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,WAAW,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAA2B;IAC5D,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,OAAO,kBAAkB,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;AACrD,CAAC"}

package/dist/state/io/history-io.d.ts

@@ -0,0 +1,37 @@
+/**
+ * History Markdown I/O — parse and serialize history.md files.
+ *
+ * Wraps the existing section-parsing logic from history-shadow.ts
+ * and adds serialization for round-trip support.
+ *
+ * @module state/io/history-io
+ */
+import type { ParsedHistory, HistorySection } from '../../agents/history-shadow.js';
+export type { ParsedHistory, HistorySection };
+/**
+ * Parse history markdown into typed sections.
+ *
+ * Mirrors the section-extraction logic in `readHistory()` from
+ * history-shadow.ts but operates purely on a string (no filesystem).
+ *
+ * Note: the original regex uses `\Z` which is not a valid JS anchor.
+ * We use an explicit section-split approach to correctly handle the
+ * last section in the file.
+ */
+export declare function parseHistory(markdown: string): ParsedHistory;
+/**
+ * Serialize a ParsedHistory back to markdown.
+ *
+ * Reconstructs the history.md with `# AgentName` header and `## Section` blocks.
+ */
+export declare function serializeHistory(history: ParsedHistory): string;
+/**
+ * Produce a string fragment for appending a new entry to a history section.
+ *
+ * @param section - Target section name (e.g., 'Learnings')
+ * @param entry - Content to append (without date header)
+ * @param date - Optional ISO date string (defaults to today)
+ * @returns Formatted entry string including `### YYYY-MM-DD` sub-header
+ */
+export declare function serializeHistoryAppend(section: HistorySection, entry: string, date?: string): string;
+//# sourceMappingURL=history-io.d.ts.map

package/dist/state/io/history-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-io.d.ts","sourceRoot":"","sources":["../../../src/state/io/history-io.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGpF,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,CAAC;AAY9C;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAsC5D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAyB/D;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,GACZ,MAAM,CAGR"}

package/dist/state/io/history-io.js

@@ -0,0 +1,102 @@
+/**
+ * History Markdown I/O — parse and serialize history.md files.
+ *
+ * Wraps the existing section-parsing logic from history-shadow.ts
+ * and adds serialization for round-trip support.
+ *
+ * @module state/io/history-io
+ */
+import { normalizeEol } from '../../utils/normalize-eol.js';
+/** Standard sections in order of appearance. */
+const SECTION_ORDER = [
+    { header: 'Context', key: 'context' },
+    { header: 'Learnings', key: 'learnings' },
+    { header: 'Decisions', key: 'decisions' },
+    { header: 'Patterns', key: 'patterns' },
+    { header: 'Issues', key: 'issues' },
+    { header: 'References', key: 'references' },
+];
+/**
+ * Parse history markdown into typed sections.
+ *
+ * Mirrors the section-extraction logic in `readHistory()` from
+ * history-shadow.ts but operates purely on a string (no filesystem).
+ *
+ * Note: the original regex uses `\Z` which is not a valid JS anchor.
+ * We use an explicit section-split approach to correctly handle the
+ * last section in the file.
+ */
+export function parseHistory(markdown) {
+    const content = normalizeEol(markdown);
+    const parsed = { fullContent: content };
+    if (!content || content.trim().length === 0) {
+        return parsed;
+    }
+    // Build a map of h2 section name → content by splitting at ## headers.
+    // Uses header start positions as boundaries (avoids the broken \Z anchor
+    // in the original readHistory regex).
+    const headerRegex = /^##\s+(.+?)\s*$/gm;
+    const headers = [];
+    let m;
+    while ((m = headerRegex.exec(content)) !== null) {
+        headers.push({ name: m[1], start: m.index, contentStart: m.index + m[0].length });
+    }
+    const sectionMap = new Map();
+    for (let i = 0; i < headers.length; i++) {
+        const hdr = headers[i];
+        const nextHdr = headers[i + 1];
+        const start = hdr.contentStart;
+        const end = nextHdr ? nextHdr.start : content.length;
+        const sectionContent = content.substring(start, end).trim();
+        if (sectionContent.length > 0) {
+            sectionMap.set(hdr.name, sectionContent);
+        }
+    }
+    for (const { header, key } of SECTION_ORDER) {
+        const value = sectionMap.get(header);
+        if (value !== undefined) {
+            parsed[key] = value;
+        }
+    }
+    return parsed;
+}
+/**
+ * Serialize a ParsedHistory back to markdown.
+ *
+ * Reconstructs the history.md with `# AgentName` header and `## Section` blocks.
+ */
+export function serializeHistory(history) {
+    // If fullContent has a title line, extract it; otherwise use a generic header
+    const titleMatch = history.fullContent.match(/^#\s+(.+)$/m);
+    const lines = [];
+    if (titleMatch) {
+        lines.push(titleMatch[0]);
+        lines.push('');
+    }
+    for (const { header, key } of SECTION_ORDER) {
+        const value = history[key];
+        if (value !== undefined && value.length > 0) {
+            lines.push(`## ${header}`);
+            lines.push('');
+            lines.push(value);
+            lines.push('');
+        }
+    }
+    if (lines.length === 0) {
+        return '';
+    }
+    return lines.join('\n').trimEnd() + '\n';
+}
+/**
+ * Produce a string fragment for appending a new entry to a history section.
+ *
+ * @param section - Target section name (e.g., 'Learnings')
+ * @param entry - Content to append (without date header)
+ * @param date - Optional ISO date string (defaults to today)
+ * @returns Formatted entry string including `### YYYY-MM-DD` sub-header
+ */
+export function serializeHistoryAppend(section, entry, date) {
+    const dateStr = date ?? new Date().toISOString().split('T')[0];
+    return `### ${dateStr}\n\n${entry}\n`;
+}
+//# sourceMappingURL=history-io.js.map

package/dist/state/io/history-io.js.map

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

package/dist/state/io/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * State I/O barrel — Markdown parsers and serializers for .squad/ domain files.
+ *
+ * Each module handles round-trip I/O for a single document type:
+ * parse(markdown) → typed object → serialize(object) → markdown.
+ *
+ * @module state/io
+ */
+export { parseCharter, serializeCharter } from './charter-io.js';
+export type { ParsedCharter } from './charter-io.js';
+export { parseHistory, serializeHistory, serializeHistoryAppend } from './history-io.js';
+export type { ParsedHistory, HistorySection } from './history-io.js';
+export { parseDecisions, serializeDecision, serializeDecisions } from './decisions-io.js';
+export type { ParsedDecision } from './decisions-io.js';
+export { parseRouting, serializeRouting } from './routing-io.js';
+export type { ParsedRoutingRule, ParsedRouting } from './routing-io.js';
+export { parseTeam, serializeTeam } from './team-io.js';
+export type { ParsedAgent, TeamMetadata, ParsedTeam } from './team-io.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/state/io/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/state/io/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACjE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzF,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGrE,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC1F,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACjE,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGxE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACxD,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}