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

package/dist/state/collections.js

@@ -0,0 +1,317 @@
+/**
+ * State Module — Typed Collection Facades
+ *
+ * Each class provides a typed, ergonomic interface over a specific
+ * `.squad/` collection, backed by StorageProvider + IO layer.
+ *
+ * @module state/collections
+ */
+import { NotFoundError, ParseError } from './domain-types.js';
+import { resolveCollectionPath } from './schema.js';
+import { createAgentHandle } from './handles.js';
+import { parseDecisions, serializeDecision, serializeDecisions } from './io/decisions-io.js';
+import { parseRouting, serializeRouting } from './io/routing-io.js';
+import { parseTeam, serializeTeam } from './io/team-io.js';
+import { parseSkillFile } from '../skills/skill-loader.js';
+// ── AgentsCollection ───────────────────────────────────────────────────────
+export class AgentsCollection {
+    storage;
+    rootDir;
+    constructor(storage, rootDir) {
+        this.storage = storage;
+        this.rootDir = rootDir;
+    }
+    /** Return a handle for interacting with a specific agent's state. */
+    get(name) {
+        return createAgentHandle(name, this.storage, this.rootDir);
+    }
+    /** List agent names from `.squad/agents/`. */
+    async list() {
+        const agentsDir = `${this.rootDir}/.squad/agents`;
+        return this.storage.list(agentsDir);
+    }
+    /** Create a new agent with charter and empty history. */
+    async create(name, charter) {
+        const agentDir = `${this.rootDir}/.squad/agents/${name}`;
+        await this.storage.write(`${agentDir}/charter.md`, charter);
+        await this.storage.write(`${agentDir}/history.md`, `# ${name}\n\n## Learnings\n\n## Context\n`);
+    }
+    /** Soft-delete an agent by removing its directory. */
+    async delete(name) {
+        const agentDir = `${this.rootDir}/.squad/agents/${name}`;
+        const exists = await this.storage.exists(agentDir);
+        if (!exists) {
+            throw new NotFoundError('agents', name);
+        }
+        await this.storage.deleteDir(agentDir);
+    }
+}
+// ── DecisionsCollection ────────────────────────────────────────────────────
+/** Map a ParsedDecision to the domain Decision type. */
+function toDomainDecision(pd) {
+    return {
+        date: pd.date ?? '',
+        title: pd.title,
+        author: pd.author ?? '',
+        body: pd.body,
+        configRelevant: pd.configRelevant,
+    };
+}
+/** Map a domain Decision to ParsedDecision for serialization. */
+function toParsedDecision(d) {
+    return {
+        title: d.title,
+        body: d.body,
+        configRelevant: d.configRelevant,
+        date: d.date || undefined,
+        author: d.author || undefined,
+    };
+}
+export class DecisionsCollection {
+    storage;
+    rootDir;
+    constructor(storage, rootDir) {
+        this.storage = storage;
+        this.rootDir = rootDir;
+    }
+    /** Parse and return all decisions from `decisions.md`. */
+    async list() {
+        const filePath = `${this.rootDir}/${resolveCollectionPath('decisions')}`;
+        const content = await this.storage.read(filePath);
+        if (content === undefined) {
+            return [];
+        }
+        try {
+            return parseDecisions(content).map(toDomainDecision);
+        }
+        catch (err) {
+            throw new ParseError('decisions', err instanceof Error ? err.message : String(err), { cause: err });
+        }
+    }
+    /** Append a new decision. Date is auto-generated if not provided. */
+    async add(decision) {
+        const filePath = `${this.rootDir}/${resolveCollectionPath('decisions')}`;
+        const date = new Date().toISOString().split('T')[0];
+        const full = { ...decision, date };
+        const parsed = toParsedDecision(full);
+        const existing = await this.storage.read(filePath);
+        if (existing === undefined || existing.trim().length === 0) {
+            await this.storage.write(filePath, serializeDecisions([parsed]));
+        }
+        else {
+            const fragment = '\n\n' + serializeDecision(parsed) + '\n';
+            await this.storage.append(filePath, fragment);
+        }
+    }
+}
+// ── RoutingCollection ──────────────────────────────────────────────────────
+/** Map ParsedRouting to RoutingConfig. */
+function toRoutingConfig(parsed) {
+    return {
+        rules: parsed.rules.map((r) => ({
+            workType: r.workType,
+            agents: r.agents,
+            examples: r.examples ?? [],
+        })),
+        moduleOwnership: parsed.moduleOwnership,
+        principles: [],
+    };
+}
+/** Map RoutingConfig rules back to ParsedRoutingRule[]. */
+function toParsedRoutingRules(config) {
+    return config.rules.map((r) => ({
+        workType: r.workType,
+        agents: [...r.agents],
+        examples: [...r.examples],
+    }));
+}
+export class RoutingCollection {
+    storage;
+    rootDir;
+    constructor(storage, rootDir) {
+        this.storage = storage;
+        this.rootDir = rootDir;
+    }
+    /** Parse and return the routing configuration. */
+    async get() {
+        const filePath = `${this.rootDir}/${resolveCollectionPath('routing')}`;
+        const content = await this.storage.read(filePath);
+        if (content === undefined) {
+            throw new NotFoundError('routing');
+        }
+        try {
+            return toRoutingConfig(parseRouting(content));
+        }
+        catch (err) {
+            throw new ParseError('routing', err instanceof Error ? err.message : String(err), { cause: err });
+        }
+    }
+    /** Write back a full routing configuration. */
+    async update(config) {
+        const filePath = `${this.rootDir}/${resolveCollectionPath('routing')}`;
+        const rules = toParsedRoutingRules(config);
+        await this.storage.write(filePath, serializeRouting(rules));
+    }
+}
+// ── TeamCollection ─────────────────────────────────────────────────────────
+/** Map ParsedTeam to TeamConfig. */
+function toTeamConfig(parsed) {
+    return {
+        projectContext: parsed.projectContext,
+        members: parsed.agents.map((a) => ({
+            name: a.name,
+            role: a.role,
+            status: a.status,
+        })),
+    };
+}
+/** Map TeamConfig members back to ParsedAgent[]. */
+function toParsedAgents(config) {
+    return config.members.map((m) => ({
+        name: m.name,
+        role: m.role,
+        skills: [],
+        status: m.status,
+    }));
+}
+export class TeamCollection {
+    storage;
+    rootDir;
+    constructor(storage, rootDir) {
+        this.storage = storage;
+        this.rootDir = rootDir;
+    }
+    /** Parse and return the team configuration. */
+    async get() {
+        const filePath = `${this.rootDir}/${resolveCollectionPath('team')}`;
+        const content = await this.storage.read(filePath);
+        if (content === undefined) {
+            throw new NotFoundError('team');
+        }
+        try {
+            return toTeamConfig(parseTeam(content));
+        }
+        catch (err) {
+            throw new ParseError('team', err instanceof Error ? err.message : String(err), { cause: err });
+        }
+    }
+    /** Write back a full team configuration. */
+    async update(config) {
+        const filePath = `${this.rootDir}/${resolveCollectionPath('team')}`;
+        const agents = toParsedAgents(config);
+        await this.storage.write(filePath, serializeTeam(agents));
+    }
+}
+// ── SkillsCollection ──────────────────────────────────────────────────────
+export class SkillsCollection {
+    storage;
+    rootDir;
+    constructor(storage, rootDir) {
+        this.storage = storage;
+        this.rootDir = rootDir;
+    }
+    /** List all skill IDs (directory names under .squad/skills/). */
+    async list() {
+        const skillsDir = `${this.rootDir}/.squad/skills`;
+        return this.storage.list(skillsDir);
+    }
+    /** Get a skill definition by ID. Returns undefined if not found or unparseable. */
+    async get(id) {
+        const skillFile = `${this.rootDir}/${resolveCollectionPath('skills', id)}/SKILL.md`;
+        const content = await this.storage.read(skillFile);
+        if (content === undefined)
+            return undefined;
+        return parseSkillFile(id, content);
+    }
+    /** Check if a skill exists. */
+    async exists(id) {
+        const skillFile = `${this.rootDir}/${resolveCollectionPath('skills', id)}/SKILL.md`;
+        return this.storage.exists(skillFile);
+    }
+}
+// ── TemplatesCollection ───────────────────────────────────────────────────
+export class TemplatesCollection {
+    storage;
+    rootDir;
+    constructor(storage, rootDir) {
+        this.storage = storage;
+        this.rootDir = rootDir;
+    }
+    /** List template filenames under .squad/templates/. */
+    async list() {
+        const templatesDir = `${this.rootDir}/.squad/templates`;
+        return this.storage.list(templatesDir);
+    }
+    /** Get raw template content by ID. Returns undefined if not found. */
+    async get(id) {
+        const filePath = `${this.rootDir}/${resolveCollectionPath('templates', id)}`;
+        return this.storage.read(filePath);
+    }
+    /** Check if a template exists. */
+    async exists(id) {
+        const filePath = `${this.rootDir}/${resolveCollectionPath('templates', id)}`;
+        return this.storage.exists(filePath);
+    }
+}
+const DEFAULT_CONFIG = {
+    cacheEnabled: false,
+    cacheTtlMs: 300_000,
+};
+export class ConfigCollection {
+    storage;
+    rootDir;
+    constructor(storage, rootDir) {
+        this.storage = storage;
+        this.rootDir = rootDir;
+    }
+    /** Read and parse `.squad/config.json`. Returns defaults when file is missing or invalid. */
+    async get() {
+        const filePath = `${this.rootDir}/${resolveCollectionPath('config')}`;
+        const content = await this.storage.read(filePath);
+        if (content === undefined) {
+            return { ...DEFAULT_CONFIG };
+        }
+        try {
+            const parsed = JSON.parse(content);
+            return { ...DEFAULT_CONFIG, ...parsed };
+        }
+        catch {
+            return { ...DEFAULT_CONFIG };
+        }
+    }
+    /** Write config to `.squad/config.json`. */
+    async update(config) {
+        const filePath = `${this.rootDir}/${resolveCollectionPath('config')}`;
+        await this.storage.write(filePath, JSON.stringify(config, null, 2) + '\n');
+    }
+    /** Check if `.squad/config.json` exists. */
+    async exists() {
+        const filePath = `${this.rootDir}/${resolveCollectionPath('config')}`;
+        return this.storage.exists(filePath);
+    }
+}
+// ── LogCollection ─────────────────────────────────────────────────────────
+export class LogCollection {
+    storage;
+    rootDir;
+    constructor(storage, rootDir) {
+        this.storage = storage;
+        this.rootDir = rootDir;
+    }
+    /** List log entry filenames under .squad/log/. */
+    async list() {
+        const logDir = `${this.rootDir}/${resolveCollectionPath('log')}`;
+        return this.storage.list(logDir);
+    }
+    /** Read a specific log entry. Returns undefined if not found. */
+    async get(id) {
+        const filePath = `${this.rootDir}/${resolveCollectionPath('log')}/${id}`;
+        return this.storage.read(filePath);
+    }
+    /** Write a new log entry. */
+    async write(id, content) {
+        const filePath = `${this.rootDir}/${resolveCollectionPath('log')}/${id}`;
+        await this.storage.write(filePath, content);
+    }
+}
+//# sourceMappingURL=collections.js.map

package/dist/state/collections.js.map

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

package/dist/state/domain-types.d.ts

@@ -0,0 +1,122 @@
+/**
+ * State Module — Canonical Domain Types
+ *
+ * Phase 2 of StorageProvider PRD (#481).
+ * Types that already exist elsewhere are re-exported here as the
+ * canonical import point for the state layer.  New domain types are
+ * defined inline.
+ */
+export type { AgentStatus } from '../agents/lifecycle.js';
+export type { HistorySection } from '../agents/history-shadow.js';
+export type { ModelTier, WorkType, RoutingRule } from '../runtime/config.js';
+export type { SkillDefinition } from '../skills/skill-loader.js';
+export type { StorageProvider } from '../storage/storage-provider.js';
+import type { HistorySection } from '../agents/history-shadow.js';
+import type { ModelTier } from '../runtime/config.js';
+import type { StorageProvider } from '../storage/storage-provider.js';
+/** Full agent entity persisted under `.squad/agents/<name>/`. */
+export interface Agent {
+    readonly name: string;
+    readonly role: string;
+    readonly emoji?: string;
+    readonly status: string;
+    readonly charterPath: string;
+    readonly modelPreference?: ModelTier;
+    readonly modelFallback?: string;
+    readonly skills: readonly string[];
+    readonly aliases: readonly string[];
+    readonly autoAssign: boolean;
+}
+/** Structured decision entry parsed from `decisions.md`. */
+export interface Decision {
+    readonly date: string;
+    readonly title: string;
+    readonly author: string;
+    readonly body: string;
+    readonly configRelevant: boolean;
+}
+/** Timestamped history entry within an agent's `history.md`. */
+export interface HistoryEntry {
+    readonly section: HistorySection;
+    readonly content: string;
+    readonly timestamp: string;
+}
+/** Parsed `team.md` structure. */
+export interface TeamConfig {
+    readonly projectContext: string;
+    readonly members: readonly TeamMember[];
+}
+/** A single row from the team.md members table. */
+export interface TeamMember {
+    readonly name: string;
+    readonly role: string;
+    readonly emoji?: string;
+    readonly status?: string;
+}
+/** Parsed `routing.md` structure. */
+export interface RoutingConfig {
+    readonly rules: readonly RoutingConfigRule[];
+    readonly moduleOwnership: ReadonlyMap<string, string>;
+    readonly principles: readonly string[];
+}
+/** A single routing rule within RoutingConfig. */
+export interface RoutingConfigRule {
+    readonly workType: string;
+    readonly agents: readonly string[];
+    readonly examples: readonly string[];
+}
+/** Template file content from `.squad/templates/`. */
+export type Template = {
+    readonly id: string;
+    readonly name: string;
+    readonly content: string;
+};
+/** Log entry for orchestration / session logging. */
+export interface LogEntry {
+    readonly timestamp: string;
+    readonly level: 'info' | 'warn' | 'error' | 'debug';
+    readonly message: string;
+    readonly agent?: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+/** Options for SquadState initialization. */
+export interface SquadStateConfig {
+    readonly provider: StorageProvider;
+    readonly rootDir: string;
+    readonly cacheEnabled?: boolean;
+    readonly cacheTtlMs?: number;
+}
+/**
+ * Discriminant for state-layer storage errors.
+ * Distinct from the low-level `StorageError` in `storage/storage-error.ts`
+ * which wraps Node.js `ErrnoException`.
+ */
+export type StateErrorKind = 'not-found' | 'parse-error' | 'write-conflict' | 'provider-error';
+/**
+ * Base error class for the state layer.
+ *
+ * Named `StateError` (not `StorageError`) to avoid collision with the
+ * low-level FS error wrapper in `storage/storage-error.ts`.  Uses a
+ * `kind` discriminant so callers can switch on error type.
+ */
+export declare class StateError extends Error {
+    readonly kind: StateErrorKind;
+    constructor(kind: StateErrorKind, message: string, options?: ErrorOptions);
+}
+/** Thrown when a requested entity or path does not exist. */
+export declare class NotFoundError extends StateError {
+    constructor(collection: string, id?: string, options?: ErrorOptions);
+}
+/** Thrown when file content cannot be parsed into the expected type. */
+export declare class ParseError extends StateError {
+    constructor(collection: string, detail: string, options?: ErrorOptions);
+}
+/** Thrown on concurrent write conflicts (future optimistic locking). */
+export declare class WriteConflictError extends StateError {
+    constructor(collection: string, id?: string, options?: ErrorOptions);
+}
+/** Thrown when the underlying StorageProvider operation fails. */
+export declare class ProviderError extends StateError {
+    constructor(operation: string, detail: string, options?: ErrorOptions);
+}
+//# sourceMappingURL=domain-types.d.ts.map

package/dist/state/domain-types.d.ts.map

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

package/dist/state/domain-types.js

@@ -0,0 +1,54 @@
+/**
+ * State Module — Canonical Domain Types
+ *
+ * Phase 2 of StorageProvider PRD (#481).
+ * Types that already exist elsewhere are re-exported here as the
+ * canonical import point for the state layer.  New domain types are
+ * defined inline.
+ */
+/**
+ * Base error class for the state layer.
+ *
+ * Named `StateError` (not `StorageError`) to avoid collision with the
+ * low-level FS error wrapper in `storage/storage-error.ts`.  Uses a
+ * `kind` discriminant so callers can switch on error type.
+ */
+export class StateError extends Error {
+    kind;
+    constructor(kind, message, options) {
+        super(message, options);
+        this.name = 'StateError';
+        this.kind = kind;
+    }
+}
+/** Thrown when a requested entity or path does not exist. */
+export class NotFoundError extends StateError {
+    constructor(collection, id, options) {
+        const target = id ? `${collection}/${id}` : collection;
+        super('not-found', `Not found: ${target}`, options);
+        this.name = 'NotFoundError';
+    }
+}
+/** Thrown when file content cannot be parsed into the expected type. */
+export class ParseError extends StateError {
+    constructor(collection, detail, options) {
+        super('parse-error', `Parse error in ${collection}: ${detail}`, options);
+        this.name = 'ParseError';
+    }
+}
+/** Thrown on concurrent write conflicts (future optimistic locking). */
+export class WriteConflictError extends StateError {
+    constructor(collection, id, options) {
+        const target = id ? `${collection}/${id}` : collection;
+        super('write-conflict', `Write conflict: ${target}`, options);
+        this.name = 'WriteConflictError';
+    }
+}
+/** Thrown when the underlying StorageProvider operation fails. */
+export class ProviderError extends StateError {
+    constructor(operation, detail, options) {
+        super('provider-error', `Provider ${operation} failed: ${detail}`, options);
+        this.name = 'ProviderError';
+    }
+}
+//# sourceMappingURL=domain-types.js.map

package/dist/state/domain-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-types.js","sourceRoot":"","sources":["../../src/state/domain-types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAsGH;;;;;;GAMG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC1B,IAAI,CAAiB;IAE9B,YAAY,IAAoB,EAAE,OAAe,EAAE,OAAsB;QACvE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,6DAA6D;AAC7D,MAAM,OAAO,aAAc,SAAQ,UAAU;IAC3C,YAAY,UAAkB,EAAE,EAAW,EAAE,OAAsB;QACjE,MAAM,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;QACvD,KAAK,CAAC,WAAW,EAAE,cAAc,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,wEAAwE;AACxE,MAAM,OAAO,UAAW,SAAQ,UAAU;IACxC,YAAY,UAAkB,EAAE,MAAc,EAAE,OAAsB;QACpE,KAAK,CAAC,aAAa,EAAE,kBAAkB,UAAU,KAAK,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;QACzE,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED,wEAAwE;AACxE,MAAM,OAAO,kBAAmB,SAAQ,UAAU;IAChD,YAAY,UAAkB,EAAE,EAAW,EAAE,OAAsB;QACjE,MAAM,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;QACvD,KAAK,CAAC,gBAAgB,EAAE,mBAAmB,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;QAC9D,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,kEAAkE;AAClE,MAAM,OAAO,aAAc,SAAQ,UAAU;IAC3C,YAAY,SAAiB,EAAE,MAAc,EAAE,OAAsB;QACnE,KAAK,CAAC,gBAAgB,EAAE,YAAY,SAAS,YAAY,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;QAC5E,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}

package/dist/state/handles.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 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 type { StorageProvider } from '../storage/storage-provider.js';
+import type { AgentHandle } from './collection-map.js';
+/**
+ * Create a concrete AgentHandle bound to a specific agent, storage provider,
+ * and root directory.
+ */
+export declare function createAgentHandle(name: string, storage: StorageProvider, rootDir: string): AgentHandle;
+//# sourceMappingURL=handles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handles.d.ts","sourceRoot":"","sources":["../../src/state/handles.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAsEvD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,MAAM,GACd,WAAW,CA0Gb"}