@bradygaster/squad-sdk 0.8.20 → 0.8.21

package/dist/sharing/consult.js

@@ -51,22 +51,22 @@ export class ExtractionDisabledError extends Error {
  * Consult mode preamble to inject after frontmatter in squad.agent.md.
  * This tells Squad it's in consult mode and should skip Init Mode.
  */
-const CONSULT_MODE_PREAMBLE = `
-<!-- consult-mode: true -->
-
-## ⚡ Consult Mode Active
-
-This project is in **consult mode**. Your personal squad has been copied into \`.squad/\` for this session.
-
-**Key differences from normal mode:**
-- **Skip Init Mode** — The team already exists (copied from your personal squad)
-- **Isolated changes** — All changes stay local until you run \`squad extract\`
-- **Invisible to project** — Both \`.squad/\` and this agent file are in \`.git/info/exclude\`
-
-**When done:** Run \`squad extract\` to review learnings and merge generic ones back to your personal squad.
-
----
-
+const CONSULT_MODE_PREAMBLE = `
+<!-- consult-mode: true -->
+
+## ⚡ Consult Mode Active
+
+This project is in **consult mode**. Your personal squad has been copied into \`.squad/\` for this session.
+
+**Key differences from normal mode:**
+- **Skip Init Mode** — The team already exists (copied from your personal squad)
+- **Isolated changes** — All changes stay local until you run \`squad extract\`
+- **Invisible to project** — Both \`.squad/\` and this agent file are in \`.git/info/exclude\`
+
+**When done:** Run \`squad extract\` to review learnings and merge generic ones back to your personal squad.
+
+---
+
 `;
 /**
  * Get the full squad.agent.md template path.
@@ -135,24 +135,24 @@ function getConsultAgentContent(projectName) {
         return template + '\n' + CONSULT_MODE_PREAMBLE;
     }
     // Fallback: minimal agent if template not found
-    return `---
-name: Squad
-description: "Your AI team. Consulting on ${projectName} using your personal squad."
----
-
-${CONSULT_MODE_PREAMBLE}
-
-You are **Squad (Consultant)** — working on **${projectName}** using a copy of your personal squad.
-
-### Available Context (local copy in .squad/)
-
-- **Team:** \`.squad/team.md\` for roster and roles
-- **Routing:** \`.squad/routing.md\` for task routing rules  
-- **Decisions:** \`.squad/decisions.md\` for your established patterns
-- **Skills:** \`.squad/skills/\` for reusable capabilities
-- **Agents:** \`.squad/agents/\` for your squad agents
-
-Work as you would with your personal squad, but in this external codebase.
+    return `---
+name: Squad
+description: "Your AI team. Consulting on ${projectName} using your personal squad."
+---
+
+${CONSULT_MODE_PREAMBLE}
+
+You are **Squad (Consultant)** — working on **${projectName}** using a copy of your personal squad.
+
+### Available Context (local copy in .squad/)
+
+- **Team:** \`.squad/team.md\` for roster and roles
+- **Routing:** \`.squad/routing.md\` for task routing rules  
+- **Decisions:** \`.squad/decisions.md\` for your established patterns
+- **Skills:** \`.squad/skills/\` for reusable capabilities
+- **Agents:** \`.squad/agents/\` for your squad agents
+
+Work as you would with your personal squad, but in this external codebase.
 `;
 }
 // ============================================================================
@@ -162,36 +162,36 @@ Work as you would with your personal squad, but in this external codebase.
  * Consult mode instructions to append to Scribe charter.
  * This enables Scribe to classify decisions as generic or project-specific.
  */
-const CONSULT_MODE_SCRIBE_PATCH = `
-
----
-
-## Consult Mode Extraction
-
-**This squad is in consult mode.** When merging decisions from the inbox, also classify each decision:
-
-### Classification
-
-For each decision in \`.squad/decisions/inbox/\`:
-
-1. **Generic** (applies to any project) → Copy to \`.squad/extract/\` with the same filename
-   - Signals: "always use", "never use", "prefer X over Y", "best practice", coding standards, patterns that work anywhere
-   - These will be extracted to the personal squad via \`squad extract\`
-
-2. **Project-specific** (only applies here) → Keep in local \`decisions.md\` only
-   - Signals: Contains file paths from this project, references "this project/codebase/repo", mentions project-specific config/APIs/schemas
-
-Generic decisions go to BOTH \`.squad/decisions.md\` (for this session) AND \`.squad/extract/\` (for later extraction).
-
-### Extract Directory
-
-\`\`\`
-.squad/extract/           # Generic learnings staged for personal squad
-├── decision-1.md         # Ready for extraction
-└── pattern-auth.md       # Ready for extraction
-\`\`\`
-
-Run \`squad extract\` to review and merge these to your personal squad.
+const CONSULT_MODE_SCRIBE_PATCH = `
+
+---
+
+## Consult Mode Extraction
+
+**This squad is in consult mode.** When merging decisions from the inbox, also classify each decision:
+
+### Classification
+
+For each decision in \`.squad/decisions/inbox/\`:
+
+1. **Generic** (applies to any project) → Copy to \`.squad/extract/\` with the same filename
+   - Signals: "always use", "never use", "prefer X over Y", "best practice", coding standards, patterns that work anywhere
+   - These will be extracted to the personal squad via \`squad extract\`
+
+2. **Project-specific** (only applies here) → Keep in local \`decisions.md\` only
+   - Signals: Contains file paths from this project, references "this project/codebase/repo", mentions project-specific config/APIs/schemas
+
+Generic decisions go to BOTH \`.squad/decisions.md\` (for this session) AND \`.squad/extract/\` (for later extraction).
+
+### Extract Directory
+
+\`\`\`
+.squad/extract/           # Generic learnings staged for personal squad
+├── decision-1.md         # Ready for extraction
+└── pattern-auth.md       # Ready for extraction
+\`\`\`
+
+Run \`squad extract\` to review and merge these to your personal squad.
 `;
 /**
  * Patch the Scribe charter in the copied squad with consult mode instructions.
@@ -682,14 +682,14 @@ function formatLogHeader(result, date) {
         ? `**Repository:** ${result.repoUrl}\n`
         : '';
     const licenseName = result.license.spdxId || result.license.name || result.license.type;
-    return `# ${result.projectName}
-
-${repoLine}**First consulted:** ${date}
-**Last session:** ${date}
-**License:** ${licenseName}
-
-## Extracted Learnings
-
+    return `# ${result.projectName}
+
+${repoLine}**First consulted:** ${date}
+**Last session:** ${date}
+**License:** ${licenseName}
+
+## Extracted Learnings
+
 `;
 }
 /**
@@ -697,16 +697,16 @@ ${repoLine}**First consulted:** ${date}
  */
 function formatSessionEntry(result, date) {
     if (result.extracted.length === 0) {
-        return `### ${date}
-- No learnings extracted
-
+        return `### ${date}
+- No learnings extracted
+
 `;
     }
     // Just list titles/filenames, not content
     const lines = result.extracted.map(l => `- ${l.filename}`);
-    return `### ${date}
-${lines.join('\n')}
-
+    return `### ${date}
+${lines.join('\n')}
+
 `;
 }
 // ============================================================================

package/dist/streams/filter.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Workstream-Aware Issue Filtering
+ *
+ * Filters GitHub issues to only those matching a workstream's labelFilter.
+ * Intended to scope work to the active workstream during triage.
+ *
+ * @module streams/filter
+ */
+import type { ResolvedWorkstream } from './types.js';
+/** Minimal issue shape for filtering. */
+export interface WorkstreamIssue {
+    number: number;
+    title: string;
+    labels: Array<{
+        name: string;
+    }>;
+}
+/** @deprecated Use WorkstreamIssue instead */
+export type StreamIssue = WorkstreamIssue;
+/**
+ * Filter issues to only those matching the workstream's label filter.
+ *
+ * Matching is case-insensitive. If the workstream has no labelFilter,
+ * all issues are returned (passthrough).
+ *
+ * @param issues - Array of issues to filter
+ * @param workstream - The resolved workstream to filter by
+ * @returns Filtered array of issues matching the workstream's label
+ */
+export declare function filterIssuesByWorkstream(issues: WorkstreamIssue[], workstream: ResolvedWorkstream): WorkstreamIssue[];
+/** @deprecated Use filterIssuesByWorkstream instead */
+export declare const filterIssuesByStream: typeof filterIssuesByWorkstream;
+//# sourceMappingURL=filter.d.ts.map

package/dist/streams/filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../src/streams/filter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,yCAAyC;AACzC,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjC;AAED,8CAA8C;AAC9C,MAAM,MAAM,WAAW,GAAG,eAAe,CAAC;AAE1C;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,eAAe,EAAE,EACzB,UAAU,EAAE,kBAAkB,GAC7B,eAAe,EAAE,CAUnB;AAED,uDAAuD;AACvD,eAAO,MAAM,oBAAoB,iCAA2B,CAAC"}

package/dist/streams/filter.js

@@ -0,0 +1,29 @@
+/**
+ * Workstream-Aware Issue Filtering
+ *
+ * Filters GitHub issues to only those matching a workstream's labelFilter.
+ * Intended to scope work to the active workstream during triage.
+ *
+ * @module streams/filter
+ */
+/**
+ * Filter issues to only those matching the workstream's label filter.
+ *
+ * Matching is case-insensitive. If the workstream has no labelFilter,
+ * all issues are returned (passthrough).
+ *
+ * @param issues - Array of issues to filter
+ * @param workstream - The resolved workstream to filter by
+ * @returns Filtered array of issues matching the workstream's label
+ */
+export function filterIssuesByWorkstream(issues, workstream) {
+    const filter = workstream.definition.labelFilter;
+    if (!filter) {
+        return issues;
+    }
+    const normalizedFilter = filter.toLowerCase();
+    return issues.filter(issue => issue.labels.some(label => label.name.toLowerCase() === normalizedFilter));
+}
+/** @deprecated Use filterIssuesByWorkstream instead */
+export const filterIssuesByStream = filterIssuesByWorkstream;
+//# sourceMappingURL=filter.js.map

package/dist/streams/filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../src/streams/filter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAcH;;;;;;;;;GASG;AACH,MAAM,UAAU,wBAAwB,CACtC,MAAyB,EACzB,UAA8B;IAE9B,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,WAAW,CAAC;IACjD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,gBAAgB,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IAC9C,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC3B,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,gBAAgB,CAAC,CAC1E,CAAC;AACJ,CAAC;AAED,uDAAuD;AACvD,MAAM,CAAC,MAAM,oBAAoB,GAAG,wBAAwB,CAAC"}

package/dist/streams/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Workstreams module — barrel exports.
+ *
+ * @module streams
+ */
+export * from './types.js';
+export * from './resolver.js';
+export * from './filter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/streams/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}

package/dist/streams/index.js

@@ -0,0 +1,9 @@
+/**
+ * Workstreams module — barrel exports.
+ *
+ * @module streams
+ */
+export * from './types.js';
+export * from './resolver.js';
+export * from './filter.js';
+//# sourceMappingURL=index.js.map

package/dist/streams/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/streams/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}

package/dist/streams/resolver.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Workstream Resolver — Resolves which workstream is active.
+ *
+ * Resolution order:
+ *   1. SQUAD_TEAM env var → look up in workstreams config
+ *   2. .squad-workstream file (gitignored) → contains workstream name
+ *   3. If exactly one workstream is defined in the config, auto-select that workstream
+ *   4. null (no active workstream — single-squad mode / no workstreams)
+ *
+ * @module streams/resolver
+ */
+import type { WorkstreamConfig, ResolvedWorkstream } from './types.js';
+/**
+ * Load workstreams configuration from .squad/workstreams.json.
+ *
+ * @param squadRoot - Root directory of the project (where .squad/ lives)
+ * @returns Parsed WorkstreamConfig or null if not found / invalid
+ */
+export declare function loadWorkstreamsConfig(squadRoot: string): WorkstreamConfig | null;
+/** @deprecated Use loadWorkstreamsConfig instead */
+export declare const loadStreamsConfig: typeof loadWorkstreamsConfig;
+/**
+ * Resolve which workstream is active for the current environment.
+ *
+ * @param squadRoot - Root directory of the project
+ * @returns ResolvedWorkstream or null if no workstream is active
+ */
+export declare function resolveWorkstream(squadRoot: string): ResolvedWorkstream | null;
+/** @deprecated Use resolveWorkstream instead */
+export declare const resolveStream: typeof resolveWorkstream;
+/**
+ * Get the GitHub label filter string for a resolved workstream.
+ *
+ * @param workstream - The resolved workstream
+ * @returns Label filter string (e.g., "team:ui")
+ */
+export declare function getWorkstreamLabelFilter(workstream: ResolvedWorkstream): string;
+/** @deprecated Use getWorkstreamLabelFilter instead */
+export declare const getStreamLabelFilter: typeof getWorkstreamLabelFilter;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/streams/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/streams/resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAwB,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE7F;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CA8EhF;AAED,oDAAoD;AACpD,eAAO,MAAM,iBAAiB,8BAAwB,CAAC;AASvD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CA0D9E;AAED,gDAAgD;AAChD,eAAO,MAAM,aAAa,0BAAoB,CAAC;AAE/C;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM,CAE/E;AAED,uDAAuD;AACvD,eAAO,MAAM,oBAAoB,iCAA2B,CAAC"}

package/dist/streams/resolver.js

@@ -0,0 +1,162 @@
+/**
+ * Workstream Resolver — Resolves which workstream is active.
+ *
+ * Resolution order:
+ *   1. SQUAD_TEAM env var → look up in workstreams config
+ *   2. .squad-workstream file (gitignored) → contains workstream name
+ *   3. If exactly one workstream is defined in the config, auto-select that workstream
+ *   4. null (no active workstream — single-squad mode / no workstreams)
+ *
+ * @module streams/resolver
+ */
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+/**
+ * Load workstreams configuration from .squad/workstreams.json.
+ *
+ * @param squadRoot - Root directory of the project (where .squad/ lives)
+ * @returns Parsed WorkstreamConfig or null if not found / invalid
+ */
+export function loadWorkstreamsConfig(squadRoot) {
+    const configPath = join(squadRoot, '.squad', 'workstreams.json');
+    if (!existsSync(configPath)) {
+        return null;
+    }
+    try {
+        const raw = readFileSync(configPath, 'utf-8');
+        const rawConfig = JSON.parse(raw);
+        if (!rawConfig || typeof rawConfig !== 'object') {
+            return null;
+        }
+        const configLike = rawConfig;
+        // Derive a sane defaultWorkflow value
+        const validWorkflows = ['branch-per-issue', 'direct'];
+        const rawWorkflow = typeof configLike.defaultWorkflow === 'string' && configLike.defaultWorkflow.trim() !== ''
+            ? configLike.defaultWorkflow
+            : 'branch-per-issue';
+        const defaultWorkflow = validWorkflows.includes(rawWorkflow)
+            ? rawWorkflow
+            : 'branch-per-issue';
+        const workstreamsRaw = configLike.workstreams;
+        if (!Array.isArray(workstreamsRaw)) {
+            return null;
+        }
+        const workstreams = workstreamsRaw
+            .filter(entry => entry && typeof entry === 'object')
+            .map(entry => {
+            const e = entry;
+            if (typeof e.name !== 'string' || typeof e.labelFilter !== 'string') {
+                return null;
+            }
+            const normalized = {
+                name: e.name,
+                labelFilter: e.labelFilter,
+            };
+            if (Array.isArray(e.folderScope) && e.folderScope.every(item => typeof item === 'string')) {
+                normalized.folderScope = e.folderScope;
+            }
+            if (typeof e.workflow === 'string' && e.workflow.trim() !== '') {
+                normalized.workflow = e.workflow;
+            }
+            else {
+                normalized.workflow = defaultWorkflow;
+            }
+            if (typeof e.description === 'string') {
+                normalized.description = e.description;
+            }
+            return normalized;
+        })
+            .filter((s) => s !== null);
+        if (workstreams.length === 0) {
+            return null;
+        }
+        return { defaultWorkflow, workstreams };
+    }
+    catch {
+        return null;
+    }
+}
+/** @deprecated Use loadWorkstreamsConfig instead */
+export const loadStreamsConfig = loadWorkstreamsConfig;
+/**
+ * Find a workstream definition by name in a config.
+ */
+function findWorkstream(config, name) {
+    return config.workstreams.find(s => s.name === name);
+}
+/**
+ * Resolve which workstream is active for the current environment.
+ *
+ * @param squadRoot - Root directory of the project
+ * @returns ResolvedWorkstream or null if no workstream is active
+ */
+export function resolveWorkstream(squadRoot) {
+    const config = loadWorkstreamsConfig(squadRoot);
+    // 1. SQUAD_TEAM env var
+    const envTeam = process.env.SQUAD_TEAM;
+    if (envTeam) {
+        if (config) {
+            const def = findWorkstream(config, envTeam);
+            if (def) {
+                return { name: envTeam, definition: def, source: 'env' };
+            }
+        }
+        // Env var set but no matching workstream config — synthesize a minimal definition
+        return {
+            name: envTeam,
+            definition: {
+                name: envTeam,
+                labelFilter: `team:${envTeam}`,
+            },
+            source: 'env',
+        };
+    }
+    // 2. .squad-workstream file
+    const workstreamFilePath = join(squadRoot, '.squad-workstream');
+    if (existsSync(workstreamFilePath)) {
+        try {
+            const workstreamName = readFileSync(workstreamFilePath, 'utf-8').trim();
+            if (workstreamName) {
+                if (config) {
+                    const def = findWorkstream(config, workstreamName);
+                    if (def) {
+                        return { name: workstreamName, definition: def, source: 'file' };
+                    }
+                }
+                // File exists but no config — synthesize
+                return {
+                    name: workstreamName,
+                    definition: {
+                        name: workstreamName,
+                        labelFilter: `team:${workstreamName}`,
+                    },
+                    source: 'file',
+                };
+            }
+        }
+        catch {
+            // Ignore read errors
+        }
+    }
+    // 3. If exactly one workstream is defined, auto-select it
+    if (config && config.workstreams.length === 1) {
+        const def = config.workstreams[0];
+        return { name: def.name, definition: def, source: 'config' };
+    }
+    // 4. No workstream detected
+    return null;
+}
+/** @deprecated Use resolveWorkstream instead */
+export const resolveStream = resolveWorkstream;
+/**
+ * Get the GitHub label filter string for a resolved workstream.
+ *
+ * @param workstream - The resolved workstream
+ * @returns Label filter string (e.g., "team:ui")
+ */
+export function getWorkstreamLabelFilter(workstream) {
+    return workstream.definition.labelFilter;
+}
+/** @deprecated Use getWorkstreamLabelFilter instead */
+export const getStreamLabelFilter = getWorkstreamLabelFilter;
+//# sourceMappingURL=resolver.js.map

package/dist/streams/resolver.js.map

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

package/dist/streams/types.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Workstream Types — Type definitions for Squad Workstreams.
+ *
+ * Workstreams enable horizontal scaling by allowing multiple Squad instances
+ * (e.g., in different Codespaces) to each handle a scoped subset of work.
+ *
+ * @module streams/types
+ */
+/** Definition of a single workstream (team partition). */
+export interface WorkstreamDefinition {
+    /** Workstream name, e.g., "ui-team", "backend-team" */
+    name: string;
+    /** GitHub label to filter issues by, e.g., "team:ui" */
+    labelFilter: string;
+    /** Optional folder restrictions, e.g., ["apps/web"] */
+    folderScope?: string[];
+    /** Workflow mode. Default: branch-per-issue */
+    workflow?: 'branch-per-issue' | 'direct';
+    /** Human-readable description of this workstream's purpose */
+    description?: string;
+}
+/** @deprecated Use WorkstreamDefinition instead */
+export type StreamDefinition = WorkstreamDefinition;
+/** Top-level workstreams configuration (stored in .squad/workstreams.json). */
+export interface WorkstreamConfig {
+    /** All configured workstreams */
+    workstreams: WorkstreamDefinition[];
+    /** Default workflow for workstreams that don't specify one */
+    defaultWorkflow: 'branch-per-issue' | 'direct';
+}
+/** @deprecated Use WorkstreamConfig instead */
+export type StreamConfig = WorkstreamConfig;
+/** A resolved workstream with provenance information. */
+export interface ResolvedWorkstream {
+    /** Workstream name */
+    name: string;
+    /** Full workstream definition */
+    definition: WorkstreamDefinition;
+    /** How this workstream was resolved */
+    source: 'env' | 'file' | 'config';
+}
+/** @deprecated Use ResolvedWorkstream instead */
+export type ResolvedStream = ResolvedWorkstream;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/streams/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,0DAA0D;AAC1D,MAAM,WAAW,oBAAoB;IACnC,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,kBAAkB,GAAG,QAAQ,CAAC;IACzC,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,mDAAmD;AACnD,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AAEpD,+EAA+E;AAC/E,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,8DAA8D;IAC9D,eAAe,EAAE,kBAAkB,GAAG,QAAQ,CAAC;CAChD;AAED,+CAA+C;AAC/C,MAAM,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAE5C,yDAAyD;AACzD,MAAM,WAAW,kBAAkB;IACjC,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,UAAU,EAAE,oBAAoB,CAAC;IACjC,uCAAuC;IACvC,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;CACnC;AAED,iDAAiD;AACjD,MAAM,MAAM,cAAc,GAAG,kBAAkB,CAAC"}

package/dist/streams/types.js

@@ -0,0 +1,10 @@
+/**
+ * Workstream Types — Type definitions for Squad Workstreams.
+ *
+ * Workstreams enable horizontal scaling by allowing multiple Squad instances
+ * (e.g., in different Codespaces) to each handle a scoped subset of work.
+ *
+ * @module streams/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/streams/types.js.map

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

package/dist/tools/index.js

@@ -12,7 +12,7 @@
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import { randomUUID } from 'node:crypto';
-import { trace, SpanStatusCode } from '@opentelemetry/api';
+import { trace, SpanStatusCode } from '../runtime/otel-api.js';
 const tracer = trace.getTracer('squad-sdk');
 // --- Argument Sanitization ---
 /** Sensitive field patterns — strip before recording as span attributes. */