@bradygaster/squad-sdk 0.8.20 → 0.8.21

package/dist/builders/index.js

@@ -0,0 +1,404 @@
+/**
+ * Builder Functions — SDK-First Squad Mode
+ *
+ * Each builder accepts a strongly-typed config object, validates it at
+ * runtime (manual type-guards — no zod dependency), and returns the
+ * validated value with the same type. The pattern mirrors `defineConfig()`
+ * in config/schema.ts: identity-passthrough with runtime safety.
+ *
+ * @module builders
+ */
+// ---------------------------------------------------------------------------
+// Validation helpers (private)
+// ---------------------------------------------------------------------------
+class BuilderValidationError extends Error {
+    constructor(builder, reason) {
+        super(`[${builder}] ${reason}`);
+        this.name = 'BuilderValidationError';
+    }
+}
+function assertNonEmptyString(value, field, builder) {
+    if (typeof value !== 'string' || value.length === 0) {
+        throw new BuilderValidationError(builder, `"${field}" must be a non-empty string`);
+    }
+}
+function assertArray(value, field, builder) {
+    if (!Array.isArray(value)) {
+        throw new BuilderValidationError(builder, `"${field}" must be an array`);
+    }
+}
+function assertObject(value, builder) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        throw new BuilderValidationError(builder, 'config must be a plain object');
+    }
+}
+function assertOptionalString(value, field, builder) {
+    if (value !== undefined && typeof value !== 'string') {
+        throw new BuilderValidationError(builder, `"${field}" must be a string when provided`);
+    }
+}
+function assertOptionalBoolean(value, field, builder) {
+    if (value !== undefined && typeof value !== 'boolean') {
+        throw new BuilderValidationError(builder, `"${field}" must be a boolean when provided`);
+    }
+}
+function assertOptionalNumber(value, field, builder) {
+    if (value !== undefined && typeof value !== 'number') {
+        throw new BuilderValidationError(builder, `"${field}" must be a number when provided`);
+    }
+}
+function assertOptionalArray(value, field, builder) {
+    if (value !== undefined && !Array.isArray(value)) {
+        throw new BuilderValidationError(builder, `"${field}" must be an array when provided`);
+    }
+}
+function assertStringUnion(value, allowed, field, builder) {
+    if (!allowed.includes(value)) {
+        throw new BuilderValidationError(builder, `"${field}" must be one of: ${allowed.join(', ')}`);
+    }
+}
+/** Validates a model field that accepts string or ModelPreference object. */
+function assertModelPreference(value, field, builder) {
+    if (value === undefined)
+        return;
+    if (typeof value === 'string')
+        return;
+    if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+        const obj = value;
+        assertNonEmptyString(obj.preferred, `${field}.preferred`, builder);
+        assertOptionalString(obj.rationale, `${field}.rationale`, builder);
+        assertOptionalString(obj.fallback, `${field}.fallback`, builder);
+        return;
+    }
+    throw new BuilderValidationError(builder, `"${field}" must be a model string or { preferred, rationale?, fallback? }`);
+}
+// ---------------------------------------------------------------------------
+// defineTeam
+// ---------------------------------------------------------------------------
+/**
+ * Define team metadata, project context, and member roster.
+ *
+ * ```ts
+ * const team = defineTeam({
+ *   name: 'Core Squad',
+ *   description: 'The main engineering team',
+ *   members: ['@edie', '@fenster', '@hockney'],
+ * });
+ * ```
+ */
+export function defineTeam(config) {
+    assertObject(config, 'defineTeam');
+    assertNonEmptyString(config.name, 'name', 'defineTeam');
+    assertOptionalString(config.description, 'description', 'defineTeam');
+    assertOptionalString(config.projectContext, 'projectContext', 'defineTeam');
+    assertArray(config.members, 'members', 'defineTeam');
+    for (const member of config.members) {
+        assertNonEmptyString(member, 'members[]', 'defineTeam');
+    }
+    return config;
+}
+// ---------------------------------------------------------------------------
+// defineAgent
+// ---------------------------------------------------------------------------
+const AGENT_STATUSES = ['active', 'inactive', 'retired'];
+const CAPABILITY_LEVELS = ['expert', 'proficient', 'basic'];
+/**
+ * Define a single agent with its role, charter, model preference,
+ * tools, and capability profile.
+ *
+ * ```ts
+ * const edie = defineAgent({
+ *   name: 'edie',
+ *   role: 'TypeScript Engineer',
+ *   charter: '.squad/agents/edie/charter.md',
+ *   model: 'claude-sonnet-4',
+ *   tools: ['grep', 'edit', 'powershell'],
+ *   capabilities: [{ name: 'type-system', level: 'expert' }],
+ *   status: 'active',
+ * });
+ * ```
+ */
+export function defineAgent(config) {
+    assertObject(config, 'defineAgent');
+    assertNonEmptyString(config.name, 'name', 'defineAgent');
+    assertNonEmptyString(config.role, 'role', 'defineAgent');
+    assertOptionalString(config.description, 'description', 'defineAgent');
+    assertOptionalString(config.charter, 'charter', 'defineAgent');
+    assertModelPreference(config.model, 'model', 'defineAgent');
+    assertOptionalArray(config.tools, 'tools', 'defineAgent');
+    assertOptionalArray(config.capabilities, 'capabilities', 'defineAgent');
+    if (config.status !== undefined) {
+        assertStringUnion(config.status, AGENT_STATUSES, 'status', 'defineAgent');
+    }
+    if (config.capabilities) {
+        for (const cap of config.capabilities) {
+            assertObject(cap, 'defineAgent');
+            assertNonEmptyString(cap.name, 'capabilities[].name', 'defineAgent');
+            assertStringUnion(cap.level, CAPABILITY_LEVELS, 'capabilities[].level', 'defineAgent');
+        }
+    }
+    return config;
+}
+// ---------------------------------------------------------------------------
+// defineRouting
+// ---------------------------------------------------------------------------
+const ROUTING_TIERS = ['direct', 'lightweight', 'standard', 'full'];
+const FALLBACK_BEHAVIORS = ['ask', 'default-agent', 'coordinator'];
+/**
+ * Define typed routing rules with pattern matching, priority, and tier.
+ *
+ * ```ts
+ * const routing = defineRouting({
+ *   rules: [
+ *     { pattern: 'feature-*', agents: ['@edie'], tier: 'standard', priority: 1 },
+ *     { pattern: 'docs-*', agents: ['@mcmanus'], tier: 'lightweight' },
+ *   ],
+ *   defaultAgent: '@coordinator',
+ *   fallback: 'coordinator',
+ * });
+ * ```
+ */
+export function defineRouting(config) {
+    assertObject(config, 'defineRouting');
+    assertArray(config.rules, 'rules', 'defineRouting');
+    assertOptionalString(config.defaultAgent, 'defaultAgent', 'defineRouting');
+    if (config.fallback !== undefined) {
+        assertStringUnion(config.fallback, FALLBACK_BEHAVIORS, 'fallback', 'defineRouting');
+    }
+    for (const rule of config.rules) {
+        assertObject(rule, 'defineRouting');
+        assertNonEmptyString(rule.pattern, 'rules[].pattern', 'defineRouting');
+        assertArray(rule.agents, 'rules[].agents', 'defineRouting');
+        for (const agent of rule.agents) {
+            assertNonEmptyString(agent, 'rules[].agents[]', 'defineRouting');
+        }
+        if (rule.tier !== undefined) {
+            assertStringUnion(rule.tier, ROUTING_TIERS, 'rules[].tier', 'defineRouting');
+        }
+        assertOptionalNumber(rule.priority, 'rules[].priority', 'defineRouting');
+        assertOptionalString(rule.description, 'rules[].description', 'defineRouting');
+    }
+    return config;
+}
+// ---------------------------------------------------------------------------
+// defineCeremony
+// ---------------------------------------------------------------------------
+/**
+ * Define a ceremony with schedule, participants, and agenda.
+ *
+ * ```ts
+ * const standup = defineCeremony({
+ *   name: 'standup',
+ *   trigger: 'schedule',
+ *   schedule: '0 9 * * 1-5',
+ *   participants: ['@edie', '@fenster', '@hockney'],
+ *   agenda: 'Yesterday / Today / Blockers',
+ * });
+ * ```
+ */
+export function defineCeremony(config) {
+    assertObject(config, 'defineCeremony');
+    assertNonEmptyString(config.name, 'name', 'defineCeremony');
+    assertOptionalString(config.trigger, 'trigger', 'defineCeremony');
+    assertOptionalString(config.schedule, 'schedule', 'defineCeremony');
+    assertOptionalArray(config.participants, 'participants', 'defineCeremony');
+    assertOptionalString(config.agenda, 'agenda', 'defineCeremony');
+    assertOptionalArray(config.hooks, 'hooks', 'defineCeremony');
+    return config;
+}
+// ---------------------------------------------------------------------------
+// defineHooks
+// ---------------------------------------------------------------------------
+/**
+ * Define the governance hook pipeline.
+ *
+ * ```ts
+ * const hooks = defineHooks({
+ *   allowedWritePaths: ['src/**', 'test/**', '.squad/**'],
+ *   blockedCommands: ['rm -rf /', 'DROP TABLE'],
+ *   maxAskUser: 3,
+ *   scrubPii: true,
+ *   reviewerLockout: true,
+ * });
+ * ```
+ */
+export function defineHooks(config) {
+    assertObject(config, 'defineHooks');
+    assertOptionalArray(config.allowedWritePaths, 'allowedWritePaths', 'defineHooks');
+    assertOptionalArray(config.blockedCommands, 'blockedCommands', 'defineHooks');
+    assertOptionalNumber(config.maxAskUser, 'maxAskUser', 'defineHooks');
+    assertOptionalBoolean(config.scrubPii, 'scrubPii', 'defineHooks');
+    assertOptionalBoolean(config.reviewerLockout, 'reviewerLockout', 'defineHooks');
+    return config;
+}
+// ---------------------------------------------------------------------------
+// defineCasting
+// ---------------------------------------------------------------------------
+const OVERFLOW_STRATEGIES = ['reject', 'generic', 'rotate'];
+/**
+ * Define casting configuration — universe allowlists and overflow.
+ *
+ * ```ts
+ * const casting = defineCasting({
+ *   allowlistUniverses: ['The Usual Suspects', 'Breaking Bad'],
+ *   overflowStrategy: 'generic',
+ *   capacity: { 'The Usual Suspects': 8 },
+ * });
+ * ```
+ */
+export function defineCasting(config) {
+    assertObject(config, 'defineCasting');
+    assertOptionalArray(config.allowlistUniverses, 'allowlistUniverses', 'defineCasting');
+    if (config.overflowStrategy !== undefined) {
+        assertStringUnion(config.overflowStrategy, OVERFLOW_STRATEGIES, 'overflowStrategy', 'defineCasting');
+    }
+    if (config.capacity !== undefined) {
+        assertObject(config.capacity, 'defineCasting');
+        for (const [universe, count] of Object.entries(config.capacity)) {
+            if (typeof count !== 'number' || count < 0) {
+                throw new BuilderValidationError('defineCasting', `capacity["${universe}"] must be a non-negative number`);
+            }
+        }
+    }
+    return config;
+}
+// ---------------------------------------------------------------------------
+// defineTelemetry
+// ---------------------------------------------------------------------------
+/**
+ * Define OpenTelemetry configuration.
+ *
+ * ```ts
+ * const telemetry = defineTelemetry({
+ *   enabled: true,
+ *   endpoint: 'http://localhost:4317',
+ *   serviceName: 'squad',
+ *   sampleRate: 1.0,
+ *   aspireDefaults: true,
+ * });
+ * ```
+ */
+export function defineTelemetry(config) {
+    assertObject(config, 'defineTelemetry');
+    assertOptionalBoolean(config.enabled, 'enabled', 'defineTelemetry');
+    assertOptionalString(config.endpoint, 'endpoint', 'defineTelemetry');
+    assertOptionalString(config.serviceName, 'serviceName', 'defineTelemetry');
+    assertOptionalNumber(config.sampleRate, 'sampleRate', 'defineTelemetry');
+    assertOptionalBoolean(config.aspireDefaults, 'aspireDefaults', 'defineTelemetry');
+    if (config.sampleRate !== undefined && (config.sampleRate < 0 || config.sampleRate > 1)) {
+        throw new BuilderValidationError('defineTelemetry', '"sampleRate" must be between 0.0 and 1.0');
+    }
+    return config;
+}
+// ---------------------------------------------------------------------------
+// defineSkill
+// ---------------------------------------------------------------------------
+const CONFIDENCE_LEVELS = ['low', 'medium', 'high'];
+const SKILL_SOURCES = ['manual', 'observed', 'earned', 'extracted'];
+/**
+ * Define a reusable skill with patterns, context, and examples.
+ *
+ * ```ts
+ * const skill = defineSkill({
+ *   name: 'init-mode',
+ *   description: 'Team initialization flow (Phase 1 + Phase 2)',
+ *   domain: 'orchestration',
+ *   confidence: 'high',
+ *   source: 'extracted',
+ *   content: '## Context\n...\n## Patterns\n...',
+ *   tools: [{ name: 'ask_user', description: 'Confirm team roster', when: 'Phase 1 proposal' }],
+ * });
+ * ```
+ */
+export function defineSkill(config) {
+    assertObject(config, 'defineSkill');
+    assertNonEmptyString(config.name, 'name', 'defineSkill');
+    assertNonEmptyString(config.description, 'description', 'defineSkill');
+    assertNonEmptyString(config.domain, 'domain', 'defineSkill');
+    assertNonEmptyString(config.content, 'content', 'defineSkill');
+    if (config.confidence !== undefined) {
+        assertStringUnion(config.confidence, CONFIDENCE_LEVELS, 'confidence', 'defineSkill');
+    }
+    if (config.source !== undefined) {
+        assertStringUnion(config.source, SKILL_SOURCES, 'source', 'defineSkill');
+    }
+    assertOptionalArray(config.tools, 'tools', 'defineSkill');
+    if (config.tools) {
+        for (const tool of config.tools) {
+            assertObject(tool, 'defineSkill');
+            assertNonEmptyString(tool.name, 'tools[].name', 'defineSkill');
+            assertNonEmptyString(tool.description, 'tools[].description', 'defineSkill');
+            assertNonEmptyString(tool.when, 'tools[].when', 'defineSkill');
+        }
+    }
+    return config;
+}
+// ---------------------------------------------------------------------------
+// defineDefaults
+// ---------------------------------------------------------------------------
+/**
+ * Define squad-level defaults applied to all agents unless overridden.
+ *
+ * ```ts
+ * const defaults = defineDefaults({
+ *   model: { preferred: 'claude-sonnet-4', rationale: 'Good balance of speed and quality', fallback: 'claude-haiku-4.5' },
+ * });
+ * ```
+ */
+export function defineDefaults(config) {
+    assertObject(config, 'defineDefaults');
+    assertModelPreference(config.model, 'model', 'defineDefaults');
+    return config;
+}
+// ---------------------------------------------------------------------------
+// defineSquad — top-level composition
+// ---------------------------------------------------------------------------
+/**
+ * Compose all builder outputs into a single SDK config.
+ *
+ * ```ts
+ * export default defineSquad({
+ *   version: '1.0.0',
+ *   team: defineTeam({ name: 'Core', members: ['@edie'] }),
+ *   agents: [defineAgent({ name: 'edie', role: 'TypeScript Engineer' })],
+ *   routing: defineRouting({ rules: [...] }),
+ *   defaults: defineDefaults({ model: 'claude-sonnet-4' }),
+ * });
+ * ```
+ */
+export function defineSquad(config) {
+    assertObject(config, 'defineSquad');
+    assertOptionalString(config.version, 'version', 'defineSquad');
+    // Validate nested sections via their respective builders
+    defineTeam(config.team);
+    assertArray(config.agents, 'agents', 'defineSquad');
+    for (const agent of config.agents) {
+        defineAgent(agent);
+    }
+    if (config.defaults !== undefined)
+        defineDefaults(config.defaults);
+    if (config.routing !== undefined)
+        defineRouting(config.routing);
+    if (config.ceremonies !== undefined) {
+        assertArray(config.ceremonies, 'ceremonies', 'defineSquad');
+        for (const ceremony of config.ceremonies) {
+            defineCeremony(ceremony);
+        }
+    }
+    if (config.hooks !== undefined)
+        defineHooks(config.hooks);
+    if (config.casting !== undefined)
+        defineCasting(config.casting);
+    if (config.telemetry !== undefined)
+        defineTelemetry(config.telemetry);
+    if (config.skills !== undefined) {
+        assertArray(config.skills, 'skills', 'defineSquad');
+        for (const skill of config.skills) {
+            defineSkill(skill);
+        }
+    }
+    return config;
+}
+/** Exported for testing — not part of the public API contract. */
+export { BuilderValidationError };
+//# sourceMappingURL=index.js.map

package/dist/builders/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/builders/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAqCH,8EAA8E;AAC9E,+BAA+B;AAC/B,8EAA8E;AAE9E,MAAM,sBAAuB,SAAQ,KAAK;IACxC,YAAY,OAAe,EAAE,MAAc;QACzC,KAAK,CAAC,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,SAAS,oBAAoB,CAAC,KAAc,EAAE,KAAa,EAAE,OAAe;IAC1E,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,sBAAsB,CAAC,OAAO,EAAE,IAAI,KAAK,8BAA8B,CAAC,CAAC;IACrF,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,KAAc,EAAE,KAAa,EAAE,OAAe;IACjE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,sBAAsB,CAAC,OAAO,EAAE,IAAI,KAAK,oBAAoB,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,KAAc,EAAE,OAAe;IACnD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,sBAAsB,CAAC,OAAO,EAAE,+BAA+B,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAc,EAAE,KAAa,EAAE,OAAe;IAC1E,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrD,MAAM,IAAI,sBAAsB,CAAC,OAAO,EAAE,IAAI,KAAK,kCAAkC,CAAC,CAAC;IACzF,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc,EAAE,KAAa,EAAE,OAAe;IAC3E,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QACtD,MAAM,IAAI,sBAAsB,CAAC,OAAO,EAAE,IAAI,KAAK,mCAAmC,CAAC,CAAC;IAC1F,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAc,EAAE,KAAa,EAAE,OAAe;IAC1E,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrD,MAAM,IAAI,sBAAsB,CAAC,OAAO,EAAE,IAAI,KAAK,kCAAkC,CAAC,CAAC;IACzF,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc,EAAE,KAAa,EAAE,OAAe;IACzE,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,sBAAsB,CAAC,OAAO,EAAE,IAAI,KAAK,kCAAkC,CAAC,CAAC;IACzF,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CACxB,KAAc,EACd,OAAqB,EACrB,KAAa,EACb,OAAe;IAEf,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAU,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,sBAAsB,CAAC,OAAO,EAAE,IAAI,KAAK,qBAAqB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChG,CAAC;AACH,CAAC;AAED,6EAA6E;AAC7E,SAAS,qBAAqB,CAAC,KAAc,EAAE,KAAa,EAAE,OAAe;IAC3E,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO;IAChC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO;IACtC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzE,MAAM,GAAG,GAAG,KAAgC,CAAC;QAC7C,oBAAoB,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,KAAK,YAAY,EAAE,OAAO,CAAC,CAAC;QACnE,oBAAoB,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,KAAK,YAAY,EAAE,OAAO,CAAC,CAAC;QACnE,oBAAoB,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,KAAK,WAAW,EAAE,OAAO,CAAC,CAAC;QACjE,OAAO;IACT,CAAC;IACD,MAAM,IAAI,sBAAsB,CAAC,OAAO,EAAE,IAAI,KAAK,kEAAkE,CAAC,CAAC;AACzH,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU,CAAC,MAAsB;IAC/C,YAAY,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACnC,oBAAoB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;IACxD,oBAAoB,CAAC,MAAM,CAAC,WAAW,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC;IACtE,oBAAoB,CAAC,MAAM,CAAC,cAAc,EAAE,gBAAgB,EAAE,YAAY,CAAC,CAAC;IAC5E,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;IACrD,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACpC,oBAAoB,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAU,CAAC;AAClE,MAAM,iBAAiB,GAAG,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,CAAU,CAAC;AAErE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,WAAW,CAAC,MAAuB;IACjD,YAAY,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACpC,oBAAoB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;IACzD,oBAAoB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;IACzD,oBAAoB,CAAC,MAAM,CAAC,WAAW,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;IACvE,oBAAoB,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;IAC/D,qBAAqB,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;IAC5D,mBAAmB,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;IAC1D,mBAAmB,CAAC,MAAM,CAAC,YAAY,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC;IAExE,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,iBAAiB,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;IAC5E,CAAC;IAED,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QACxB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACtC,YAAY,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;YACjC,oBAAoB,CAAC,GAAG,CAAC,IAAI,EAAE,qBAAqB,EAAE,aAAa,CAAC,CAAC;YACrE,iBAAiB,CAAC,GAAG,CAAC,KAAK,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,aAAa,CAAC,CAAC;QACzF,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,CAAU,CAAC;AAC7E,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,eAAe,EAAE,aAAa,CAAU,CAAC;AAE5E;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa,CAAC,MAAyB;IACrD,YAAY,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACtC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC;IACpD,oBAAoB,CAAC,MAAM,CAAC,YAAY,EAAE,cAAc,EAAE,eAAe,CAAC,CAAC;IAE3E,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAClC,iBAAiB,CAAC,MAAM,CAAC,QAAQ,EAAE,kBAAkB,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC;IACtF,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAChC,YAAY,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;QACpC,oBAAoB,CAAC,IAAI,CAAC,OAAO,EAAE,iBAAiB,EAAE,eAAe,CAAC,CAAC;QACvE,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,gBAAgB,EAAE,eAAe,CAAC,CAAC;QAC5D,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,oBAAoB,CAAC,KAAK,EAAE,kBAAkB,EAAE,eAAe,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5B,iBAAiB,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,CAAC,CAAC;QAC/E,CAAC;QACD,oBAAoB,CAAC,IAAI,CAAC,QAAQ,EAAE,kBAAkB,EAAE,eAAe,CAAC,CAAC;QACzE,oBAAoB,CAAC,IAAI,CAAC,WAAW,EAAE,qBAAqB,EAAE,eAAe,CAAC,CAAC;IACjF,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAAC,MAA0B;IACvD,YAAY,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACvC,oBAAoB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC5D,oBAAoB,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC;IAClE,oBAAoB,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC;IACpE,mBAAmB,CAAC,MAAM,CAAC,YAAY,EAAE,cAAc,EAAE,gBAAgB,CAAC,CAAC;IAC3E,oBAAoB,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC;IAChE,mBAAmB,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC;IAE7D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,WAAW,CAAC,MAAuB;IACjD,YAAY,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACpC,mBAAmB,CAAC,MAAM,CAAC,iBAAiB,EAAE,mBAAmB,EAAE,aAAa,CAAC,CAAC;IAClF,mBAAmB,CAAC,MAAM,CAAC,eAAe,EAAE,iBAAiB,EAAE,aAAa,CAAC,CAAC;IAC9E,oBAAoB,CAAC,MAAM,CAAC,UAAU,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;IACrE,qBAAqB,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;IAClE,qBAAqB,CAAC,MAAM,CAAC,eAAe,EAAE,iBAAiB,EAAE,aAAa,CAAC,CAAC;IAEhF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,MAAM,mBAAmB,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAC;AAErE;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAC,MAAyB;IACrD,YAAY,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACtC,mBAAmB,CAAC,MAAM,CAAC,kBAAkB,EAAE,oBAAoB,EAAE,eAAe,CAAC,CAAC;IAEtF,IAAI,MAAM,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;QAC1C,iBAAiB,CAAC,MAAM,CAAC,gBAAgB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,eAAe,CAAC,CAAC;IACvG,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAClC,YAAY,CAAC,MAAM,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;QAC/C,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBAC3C,MAAM,IAAI,sBAAsB,CAC9B,eAAe,EACf,aAAa,QAAQ,kCAAkC,CACxD,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAAC,MAA2B;IACzD,YAAY,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACxC,qBAAqB,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,iBAAiB,CAAC,CAAC;IACpE,oBAAoB,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,EAAE,iBAAiB,CAAC,CAAC;IACrE,oBAAoB,CAAC,MAAM,CAAC,WAAW,EAAE,aAAa,EAAE,iBAAiB,CAAC,CAAC;IAC3E,oBAAoB,CAAC,MAAM,CAAC,UAAU,EAAE,YAAY,EAAE,iBAAiB,CAAC,CAAC;IACzE,qBAAqB,CAAC,MAAM,CAAC,cAAc,EAAE,gBAAgB,EAAE,iBAAiB,CAAC,CAAC;IAElF,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,CAAC,IAAI,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC,EAAE,CAAC;QACxF,MAAM,IAAI,sBAAsB,CAAC,iBAAiB,EAAE,0CAA0C,CAAC,CAAC;IAClG,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAU,CAAC;AAC7D,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,CAAU,CAAC;AAE7E;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,WAAW,CAAC,MAAuB;IACjD,YAAY,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACpC,oBAAoB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;IACzD,oBAAoB,CAAC,MAAM,CAAC,WAAW,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;IACvE,oBAAoB,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;IAC7D,oBAAoB,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;IAE/D,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACpC,iBAAiB,CAAC,MAAM,CAAC,UAAU,EAAE,iBAAiB,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;IACvF,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,iBAAiB,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;IAC3E,CAAC;IACD,mBAAmB,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;IAE1D,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,YAAY,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;YAClC,oBAAoB,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC;YAC/D,oBAAoB,CAAC,IAAI,CAAC,WAAW,EAAE,qBAAqB,EAAE,aAAa,CAAC,CAAC;YAC7E,oBAAoB,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,MAA0B;IACvD,YAAY,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACvC,qBAAqB,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC;IAC/D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,sCAAsC;AACtC,8EAA8E;AAE9E;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,WAAW,CAAC,MAAsB;IAChD,YAAY,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACpC,oBAAoB,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;IAE/D,yDAAyD;IACzD,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxB,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;IACpD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,WAAW,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS;QAAE,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACnE,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS;QAAE,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAChE,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACpC,WAAW,CAAC,MAAM,CAAC,UAAU,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;QAC5D,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACzC,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1D,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS;QAAE,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAChE,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS;QAAE,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACtE,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;QACpD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClC,WAAW,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,kEAAkE;AAClE,OAAO,EAAE,sBAAsB,EAAE,CAAC"}

package/dist/builders/types.d.ts

@@ -0,0 +1,187 @@
+/**
+ * Builder Types — SDK-First Squad Mode
+ *
+ * These types define the config surface for the builder functions
+ * (`defineTeam`, `defineAgent`, etc.). They are the SDK-mode complement
+ * to the existing SquadConfig / schema types. Treat these interfaces
+ * as the public contract for programmatic team definition.
+ *
+ * @module builders/types
+ */
+/** Reference to an agent by name (e.g. `"@edie"` or `"edie"`). */
+export type AgentRef = string;
+/** Cron-like schedule expression or human-readable trigger. */
+export type ScheduleExpression = string;
+/** Model identifier (same domain as runtime ModelId). */
+export type BuilderModelId = string;
+/**
+ * Structured model preference for an agent or squad-level default.
+ * Supports the 4-layer model selection hierarchy:
+ *   1. User override (runtime)
+ *   2. Charter / config preference (this type)
+ *   3. Task-aware auto-selection (runtime)
+ *   4. Default (haiku)
+ */
+export interface ModelPreference {
+    /** Preferred model identifier (e.g. `"claude-sonnet-4.5"`). */
+    readonly preferred: BuilderModelId;
+    /** Why this model was chosen — helps coordinators respect the preference. */
+    readonly rationale?: string;
+    /** Fallback model if the preferred model is unavailable. */
+    readonly fallback?: BuilderModelId;
+}
+/** Squad-level defaults applied to all agents unless overridden. */
+export interface DefaultsDefinition {
+    /** Default model preference for agents that don't specify one. */
+    readonly model?: BuilderModelId | ModelPreference;
+}
+export interface TeamDefinition {
+    /** Human-readable team name. */
+    readonly name: string;
+    /** One-liner describing the team's purpose. */
+    readonly description?: string;
+    /** Freeform project context injected into agent system prompts. */
+    readonly projectContext?: string;
+    /** Ordered list of agent refs that belong to this team. */
+    readonly members: readonly AgentRef[];
+}
+/** Agent capability descriptor. */
+export interface AgentCapability {
+    /** Capability name (e.g. `"code-review"`, `"testing"`). */
+    readonly name: string;
+    /** Proficiency level. */
+    readonly level: 'expert' | 'proficient' | 'basic';
+}
+export interface AgentDefinition {
+    /** Unique agent identifier (kebab-case, no `@` prefix). */
+    readonly name: string;
+    /** Human-readable role title. */
+    readonly role: string;
+    /** One-line tagline or description (rendered as blockquote in charter). */
+    readonly description?: string;
+    /** Path to charter markdown or inline charter text. */
+    readonly charter?: string;
+    /** Preferred model identifier or structured model preference. */
+    readonly model?: BuilderModelId | ModelPreference;
+    /** Tools this agent is allowed to use. */
+    readonly tools?: readonly string[];
+    /** Typed capability list. */
+    readonly capabilities?: readonly AgentCapability[];
+    /** Agent lifecycle status. */
+    readonly status?: 'active' | 'inactive' | 'retired';
+}
+export interface RoutingRule {
+    /** Glob or regex pattern to match against work type / issue labels. */
+    readonly pattern: string;
+    /** Agent(s) to route matching work to. */
+    readonly agents: readonly AgentRef[];
+    /** Routing tier controls how much ceremony surrounds execution. */
+    readonly tier?: 'direct' | 'lightweight' | 'standard' | 'full';
+    /** Numeric priority — lower wins. */
+    readonly priority?: number;
+    /** Human-readable description or examples for this rule. */
+    readonly description?: string;
+}
+export interface RoutingDefinition {
+    /** Ordered list of routing rules (first match wins at equal priority). */
+    readonly rules: readonly RoutingRule[];
+    /** Fallback agent when no rule matches. */
+    readonly defaultAgent?: AgentRef;
+    /** Fallback behaviour when routing is ambiguous. */
+    readonly fallback?: 'ask' | 'default-agent' | 'coordinator';
+}
+export interface CeremonyDefinition {
+    /** Ceremony name (e.g. `"standup"`, `"retrospective"`). */
+    readonly name: string;
+    /** What triggers this ceremony (e.g. `"schedule"`, `"pr-merged"`). */
+    readonly trigger?: string;
+    /** Cron expression or human-readable schedule. */
+    readonly schedule?: ScheduleExpression;
+    /** Agents that participate. */
+    readonly participants?: readonly AgentRef[];
+    /** Freeform agenda / template. */
+    readonly agenda?: string;
+    /** Hook names that fire during this ceremony. */
+    readonly hooks?: readonly string[];
+}
+export interface HooksDefinition {
+    /** Glob patterns for paths agents are allowed to write. */
+    readonly allowedWritePaths?: readonly string[];
+    /** Shell commands that agents must never execute. */
+    readonly blockedCommands?: readonly string[];
+    /** Max number of ask-user prompts per session. */
+    readonly maxAskUser?: number;
+    /** Scrub PII from agent output before persisting. */
+    readonly scrubPii?: boolean;
+    /** Prevent the PR author from approving their own PR. */
+    readonly reviewerLockout?: boolean;
+}
+export interface CastingDefinition {
+    /** Fictional universes from which agent personas are drawn. */
+    readonly allowlistUniverses?: readonly string[];
+    /** Strategy when the universe is at capacity. */
+    readonly overflowStrategy?: 'reject' | 'generic' | 'rotate';
+    /** Max agents per universe (keyed by universe name). */
+    readonly capacity?: Readonly<Record<string, number>>;
+}
+export interface TelemetryDefinition {
+    /** Master on/off switch. */
+    readonly enabled?: boolean;
+    /** OTLP endpoint URL. */
+    readonly endpoint?: string;
+    /** OTel service name. */
+    readonly serviceName?: string;
+    /** Trace sample rate (0.0 – 1.0). */
+    readonly sampleRate?: number;
+    /** Apply Aspire-compatible defaults for dashboard integration. */
+    readonly aspireDefaults?: boolean;
+}
+/** MCP tool relevant to a skill. */
+export interface SkillTool {
+    readonly name: string;
+    readonly description: string;
+    readonly when: string;
+}
+/**
+ * Skill definition for SDK-First mode.
+ * Skills are reusable capabilities that agents or the coordinator can load on demand.
+ */
+export interface SkillDefinition {
+    /** Unique skill name (kebab-case) */
+    readonly name: string;
+    /** Human-readable description */
+    readonly description: string;
+    /** Domain category (e.g., 'orchestration', 'testing', 'api-design') */
+    readonly domain: string;
+    /** Confidence level in this skill */
+    readonly confidence?: 'low' | 'medium' | 'high';
+    /** How the skill was learned */
+    readonly source?: 'manual' | 'observed' | 'earned' | 'extracted';
+    /** The skill content — patterns, context, examples, anti-patterns */
+    readonly content: string;
+    /** Optional MCP tools relevant to this skill */
+    readonly tools?: readonly SkillTool[];
+}
+export interface SquadSDKConfig {
+    /** Schema version for forward-compat. */
+    readonly version?: string;
+    /** Team metadata. */
+    readonly team: TeamDefinition;
+    /** Agent definitions. */
+    readonly agents: readonly AgentDefinition[];
+    /** Squad-level defaults applied to agents unless overridden. */
+    readonly defaults?: DefaultsDefinition;
+    /** Routing rules. */
+    readonly routing?: RoutingDefinition;
+    /** Ceremony definitions. */
+    readonly ceremonies?: readonly CeremonyDefinition[];
+    /** Hook / governance definitions. */
+    readonly hooks?: HooksDefinition;
+    /** Casting configuration. */
+    readonly casting?: CastingDefinition;
+    /** Telemetry / OTel configuration. */
+    readonly telemetry?: TelemetryDefinition;
+    /** Skill definitions. */
+    readonly skills?: readonly SkillDefinition[];
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/builders/types.js

@@ -0,0 +1,12 @@
+/**
+ * Builder Types — SDK-First Squad Mode
+ *
+ * These types define the config surface for the builder functions
+ * (`defineTeam`, `defineAgent`, etc.). They are the SDK-mode complement
+ * to the existing SquadConfig / schema types. Treat these interfaces
+ * as the public contract for programmatic team definition.
+ *
+ * @module builders/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/builders/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/builders/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}