@bradygaster/squad-sdk 0.6.2 → 0.8.0

package/dist/coordinator/response-tiers.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Response Tier Selection (M3-4, Issue #143)
+ *
+ * Not all tasks need the same level of agent involvement. This module
+ * selects one of four response tiers based on message complexity,
+ * keyword patterns, config overrides, and history hints.
+ *
+ * Tiers:
+ *   Direct      — Answer inline, no agent spawn
+ *   Lightweight — Single fast-model agent
+ *   Standard    — Single standard-model agent
+ *   Full        — Multi-agent fan-out (premium models)
+ */
+import type { SquadConfig } from '../config/schema.js';
+export type TierName = 'direct' | 'lightweight' | 'standard' | 'full';
+export type ModelTierSuggestion = 'none' | 'fast' | 'standard' | 'premium';
+export interface ResponseTier {
+    /** Tier identifier */
+    tier: TierName;
+    /** Suggested model tier */
+    modelTier: ModelTierSuggestion;
+    /** Maximum agents to spawn */
+    maxAgents: number;
+    /** Per-agent timeout in seconds */
+    timeout: number;
+}
+export interface TierContext {
+    /** Recent conversation history (summaries) */
+    recentHistory?: string[];
+    /** Names of currently available agents */
+    agentAvailability?: string[];
+    /** Number of currently active sessions */
+    currentLoad?: number;
+}
+/** Get a tier definition by name. */
+export declare function getTier(name: TierName): ResponseTier;
+/**
+ * Select the appropriate response tier for an incoming message.
+ *
+ * Priority order:
+ *  1. Config routing-rule tier overrides
+ *  2. Full-tier keyword patterns
+ *  3. Direct-tier keyword patterns (short / simple)
+ *  4. Lightweight keyword patterns
+ *  5. Context-based adjustments (load, history)
+ *  6. Default → standard
+ */
+export declare function selectResponseTier(message: string, config: SquadConfig, context?: TierContext): ResponseTier;
+//# sourceMappingURL=response-tiers.d.ts.map

package/dist/coordinator/response-tiers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-tiers.d.ts","sourceRoot":"","sources":["../../src/coordinator/response-tiers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIvD,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,aAAa,GAAG,UAAU,GAAG,MAAM,CAAC;AAEtE,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;AAE3E,MAAM,WAAW,YAAY;IAC3B,sBAAsB;IACtB,IAAI,EAAE,QAAQ,CAAC;IACf,2BAA2B;IAC3B,SAAS,EAAE,mBAAmB,CAAC;IAC/B,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,0CAA0C;IAC1C,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAuCD,qCAAqC;AACrC,wBAAgB,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,CAEpD;AA8BD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,WAAgB,GACxB,YAAY,CAoCd"}

package/dist/coordinator/response-tiers.js

@@ -0,0 +1,149 @@
+/**
+ * Response Tier Selection (M3-4, Issue #143)
+ *
+ * Not all tasks need the same level of agent involvement. This module
+ * selects one of four response tiers based on message complexity,
+ * keyword patterns, config overrides, and history hints.
+ *
+ * Tiers:
+ *   Direct      — Answer inline, no agent spawn
+ *   Lightweight — Single fast-model agent
+ *   Standard    — Single standard-model agent
+ *   Full        — Multi-agent fan-out (premium models)
+ */
+// --- Tier Definitions ---
+const TIER_DIRECT = {
+    tier: 'direct',
+    modelTier: 'none',
+    maxAgents: 0,
+    timeout: 0,
+};
+const TIER_LIGHTWEIGHT = {
+    tier: 'lightweight',
+    modelTier: 'fast',
+    maxAgents: 1,
+    timeout: 30,
+};
+const TIER_STANDARD = {
+    tier: 'standard',
+    modelTier: 'standard',
+    maxAgents: 1,
+    timeout: 120,
+};
+const TIER_FULL = {
+    tier: 'full',
+    modelTier: 'premium',
+    maxAgents: 5,
+    timeout: 300,
+};
+const TIERS = {
+    direct: TIER_DIRECT,
+    lightweight: TIER_LIGHTWEIGHT,
+    standard: TIER_STANDARD,
+    full: TIER_FULL,
+};
+/** Get a tier definition by name. */
+export function getTier(name) {
+    return { ...TIERS[name] };
+}
+// --- Keyword Patterns ---
+/** Patterns that suggest a direct (no-spawn) response. */
+const DIRECT_PATTERNS = [
+    /^(hi|hello|hey|thanks|thank you|ok|okay)\b/i,
+    /^what('s| is) (your|the) (name|version|status)\b/i,
+    /^(help|usage|how do I use)\b/i,
+    /\?$/,
+];
+/** Patterns that suggest lightweight (quick lookup / simple task). */
+const LIGHTWEIGHT_PATTERNS = [
+    /\b(list|show|display|get|find|search|where is)\b/i,
+    /\b(status|info|check)\b/i,
+    /\b(rename|move|delete|remove)\s+\w+/i,
+];
+/** Patterns that suggest full multi-agent fan-out. */
+const FULL_PATTERNS = [
+    /\b(refactor|redesign|migrate|rewrite)\b.*\b(entire|all|whole|system|codebase)\b/i,
+    /\b(implement|build|create)\b.*\b(feature|module|system|service)\b/i,
+    /\bmulti[- ]?(agent|step|file)\b/i,
+    /\b(security audit|pen\s?test|vulnerability scan)\b/i,
+    /\bfull\s+(review|analysis|sweep)\b/i,
+];
+// --- Selection Logic ---
+/**
+ * Select the appropriate response tier for an incoming message.
+ *
+ * Priority order:
+ *  1. Config routing-rule tier overrides
+ *  2. Full-tier keyword patterns
+ *  3. Direct-tier keyword patterns (short / simple)
+ *  4. Lightweight keyword patterns
+ *  5. Context-based adjustments (load, history)
+ *  6. Default → standard
+ */
+export function selectResponseTier(message, config, context = {}) {
+    const trimmed = message.trim();
+    // 1. Config override: check routing rules for explicit tier
+    const configTier = matchConfigTier(trimmed, config);
+    if (configTier)
+        return getTier(configTier);
+    // 2. Full patterns (checked first — they are most impactful)
+    if (FULL_PATTERNS.some((p) => p.test(trimmed))) {
+        return applyLoadAdjustment(getTier('full'), context);
+    }
+    // 3. Very short messages are usually direct
+    if (trimmed.length < 20 && !trimmed.includes('\n')) {
+        if (DIRECT_PATTERNS.some((p) => p.test(trimmed))) {
+            return getTier('direct');
+        }
+    }
+    // 4. Direct patterns (greetings, simple questions)
+    if (DIRECT_PATTERNS.some((p) => p.test(trimmed))) {
+        return getTier('direct');
+    }
+    // 5. Lightweight patterns
+    if (LIGHTWEIGHT_PATTERNS.some((p) => p.test(trimmed))) {
+        return applyLoadAdjustment(getTier('lightweight'), context);
+    }
+    // 6. History hint: if recent history contains multi-file changes → standard+
+    if (context.recentHistory && context.recentHistory.length > 3) {
+        return applyLoadAdjustment(getTier('standard'), context);
+    }
+    // Default: standard
+    return applyLoadAdjustment(getTier('standard'), context);
+}
+// --- Helpers ---
+function matchConfigTier(message, config) {
+    if (!config.routing?.rules)
+        return undefined;
+    const lower = message.toLowerCase();
+    for (const rule of config.routing.rules) {
+        if (!rule.tier)
+            continue;
+        // Simple pattern match against the rule pattern
+        const words = rule.pattern
+            .toLowerCase()
+            .split(/[-_\s]+/)
+            .filter((w) => w.length > 2);
+        if (words.length > 0 && words.every((w) => lower.includes(w))) {
+            return rule.tier;
+        }
+    }
+    return undefined;
+}
+/**
+ * Downgrade tier when load is high to conserve resources.
+ */
+function applyLoadAdjustment(tier, context) {
+    if (context.currentLoad === undefined)
+        return tier;
+    // If load is ≥ 4 active sessions, cap at standard
+    if (context.currentLoad >= 4 && tier.tier === 'full') {
+        return getTier('standard');
+    }
+    // If load is ≥ 6, cap at lightweight
+    if (context.currentLoad >= 6 && tier.tier === 'standard') {
+        return getTier('lightweight');
+    }
+    return tier;
+}
+//# sourceMappingURL=response-tiers.js.map

package/dist/coordinator/response-tiers.js.map

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

package/dist/hooks/index.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Hook Pipeline — Hooks & Policy Enforcement (PRD 3)
+ *
+ * Programmatic enforcement of governance policies via SDK hooks.
+ * Replaces prompt-level rules with deterministic, testable handlers.
+ *
+ * Hook types:
+ *   - onPreToolUse:  Intercept tool calls before execution (block/allow/modify)
+ *   - onPostToolUse: Inspect tool results after execution (scrub PII, log)
+ *   - onSessionStart: Inject context at session creation
+ *   - onSessionEnd:  Cleanup at session teardown
+ *   - onErrorOccurred: Handle errors from SDK or tools
+ */
+export type HookAction = 'allow' | 'block' | 'modify';
+export interface PreToolUseContext {
+    /** Name of the tool being called */
+    toolName: string;
+    /** Arguments passed to the tool */
+    arguments: Record<string, unknown>;
+    /** Agent name that invoked the tool */
+    agentName: string;
+    /** Session ID */
+    sessionId: string;
+}
+export interface PreToolUseResult {
+    action: HookAction;
+    /** Modified arguments (only if action === 'modify') */
+    modifiedArguments?: Record<string, unknown>;
+    /** Reason for blocking (only if action === 'block') */
+    reason?: string;
+}
+export interface PostToolUseContext {
+    toolName: string;
+    arguments: Record<string, unknown>;
+    result: unknown;
+    agentName: string;
+    sessionId: string;
+}
+export interface PostToolUseResult {
+    /** Scrubbed or modified result */
+    result: unknown;
+}
+export type PreToolUseHook = (ctx: PreToolUseContext) => PreToolUseResult | Promise<PreToolUseResult>;
+export type PostToolUseHook = (ctx: PostToolUseContext) => PostToolUseResult | Promise<PostToolUseResult>;
+export interface PolicyConfig {
+    /** File paths agents are allowed to write to (glob patterns) */
+    allowedWritePaths?: string[];
+    /** Shell commands that are always blocked */
+    blockedCommands?: string[];
+    /** Maximum ask_user calls per session */
+    maxAskUserPerSession?: number;
+    /** Enable PII scrubbing on tool outputs */
+    scrubPii?: boolean;
+    /** Enable reviewer lockout protocol */
+    reviewerLockout?: boolean;
+}
+export declare const DEFAULT_BLOCKED_COMMANDS: string[];
+export declare class HookPipeline {
+    private preToolHooks;
+    private postToolHooks;
+    private config;
+    private askUserCallCount;
+    private reviewerLockout;
+    constructor(config?: PolicyConfig);
+    /** Register a pre-tool-use hook */
+    addPreToolHook(hook: PreToolUseHook): void;
+    /** Register a post-tool-use hook */
+    addPostToolHook(hook: PostToolUseHook): void;
+    /** Run all pre-tool hooks in order. First 'block' wins. */
+    runPreToolHooks(ctx: PreToolUseContext): Promise<PreToolUseResult>;
+    /** Run all post-tool hooks in order */
+    runPostToolHooks(ctx: PostToolUseContext): Promise<PostToolUseResult>;
+    /** Create file-write guard hook */
+    private createFileWriteGuard;
+    /** Create shell command restriction hook */
+    private createShellCommandRestriction;
+    /** Create ask_user rate limiter hook */
+    private createAskUserRateLimiter;
+    /** Create PII scrubbing hook */
+    private createPiiScrubber;
+    /** Recursively scrub PII from object */
+    private scrubObjectRecursive;
+    /** Simple glob matcher (supports * and **) */
+    private matchGlob;
+    /** Get the reviewer lockout hook instance */
+    getReviewerLockout(): ReviewerLockoutHook;
+}
+export declare class ReviewerLockoutHook {
+    private lockoutRegistry;
+    /** Lock out an agent from an artifact */
+    lockout(artifactId: string, agentName: string): void;
+    /** Check if an agent is locked out of an artifact */
+    isLockedOut(artifactId: string, agentName: string): boolean;
+    /** Clear lockout for an artifact */
+    clearLockout(artifactId: string): void;
+    /** Get all lockouts for an artifact */
+    getLockedAgents(artifactId: string): string[];
+    /** Clear all lockouts */
+    clearAll(): void;
+    /** Create pre-tool-use hook for reviewer lockout */
+    createHook(): PreToolUseHook;
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/hooks/index.js

@@ -0,0 +1,279 @@
+/**
+ * Hook Pipeline — Hooks & Policy Enforcement (PRD 3)
+ *
+ * Programmatic enforcement of governance policies via SDK hooks.
+ * Replaces prompt-level rules with deterministic, testable handlers.
+ *
+ * Hook types:
+ *   - onPreToolUse:  Intercept tool calls before execution (block/allow/modify)
+ *   - onPostToolUse: Inspect tool results after execution (scrub PII, log)
+ *   - onSessionStart: Inject context at session creation
+ *   - onSessionEnd:  Cleanup at session teardown
+ *   - onErrorOccurred: Handle errors from SDK or tools
+ */
+export const DEFAULT_BLOCKED_COMMANDS = [
+    'rm -rf',
+    'git push --force',
+    'git rebase',
+    'git reset --hard',
+];
+// --- Hook Pipeline ---
+export class HookPipeline {
+    preToolHooks = [];
+    postToolHooks = [];
+    config;
+    askUserCallCount = new Map();
+    reviewerLockout;
+    constructor(config = {}) {
+        this.config = config;
+        this.reviewerLockout = new ReviewerLockoutHook();
+        // Register file-write guard hook
+        if (config.allowedWritePaths && config.allowedWritePaths.length > 0) {
+            this.addPreToolHook(this.createFileWriteGuard(config.allowedWritePaths));
+        }
+        // Register shell command restriction hook
+        const blockedCommands = config.blockedCommands || DEFAULT_BLOCKED_COMMANDS;
+        if (blockedCommands.length > 0) {
+            this.addPreToolHook(this.createShellCommandRestriction(blockedCommands));
+        }
+        // Register ask_user rate limiter
+        if (config.maxAskUserPerSession !== undefined && config.maxAskUserPerSession > 0) {
+            this.addPreToolHook(this.createAskUserRateLimiter(config.maxAskUserPerSession));
+        }
+        // Register reviewer lockout hook
+        if (config.reviewerLockout) {
+            this.addPreToolHook(this.reviewerLockout.createHook());
+        }
+        // Register PII scrubbing hook
+        if (config.scrubPii) {
+            this.addPostToolHook(this.createPiiScrubber());
+        }
+    }
+    /** Register a pre-tool-use hook */
+    addPreToolHook(hook) {
+        this.preToolHooks.push(hook);
+    }
+    /** Register a post-tool-use hook */
+    addPostToolHook(hook) {
+        this.postToolHooks.push(hook);
+    }
+    /** Run all pre-tool hooks in order. First 'block' wins. */
+    async runPreToolHooks(ctx) {
+        for (const hook of this.preToolHooks) {
+            const result = await hook(ctx);
+            if (result.action === 'block')
+                return result;
+            if (result.action === 'modify' && result.modifiedArguments) {
+                ctx = { ...ctx, arguments: result.modifiedArguments };
+            }
+        }
+        return { action: 'allow' };
+    }
+    /** Run all post-tool hooks in order */
+    async runPostToolHooks(ctx) {
+        let result = ctx.result;
+        for (const hook of this.postToolHooks) {
+            const hookResult = await hook({ ...ctx, result });
+            result = hookResult.result;
+        }
+        return { result };
+    }
+    /** Create file-write guard hook */
+    createFileWriteGuard(allowedPaths) {
+        return (ctx) => {
+            const writeTools = ['edit', 'create', 'write_file', 'create_file'];
+            if (!writeTools.includes(ctx.toolName)) {
+                return { action: 'allow' };
+            }
+            const filePath = ctx.arguments.path || ctx.arguments.file_path;
+            if (!filePath || typeof filePath !== 'string') {
+                return { action: 'allow' };
+            }
+            const isAllowed = allowedPaths.some(pattern => this.matchGlob(filePath, pattern));
+            if (!isAllowed) {
+                console.warn('[HookPipeline] File write blocked', {
+                    agent: ctx.agentName,
+                    tool: ctx.toolName,
+                    path: filePath,
+                    allowedPaths,
+                });
+                return {
+                    action: 'block',
+                    reason: `File write blocked: "${filePath}" does not match allowed paths. Allowed patterns: ${allowedPaths.join(', ')}`,
+                };
+            }
+            return { action: 'allow' };
+        };
+    }
+    /** Create shell command restriction hook */
+    createShellCommandRestriction(blockedCommands) {
+        return (ctx) => {
+            const shellTools = ['powershell', 'bash', 'shell', 'exec'];
+            if (!shellTools.includes(ctx.toolName)) {
+                return { action: 'allow' };
+            }
+            const command = ctx.arguments.command || ctx.arguments.cmd;
+            if (!command || typeof command !== 'string') {
+                return { action: 'allow' };
+            }
+            for (const blocked of blockedCommands) {
+                if (command.includes(blocked)) {
+                    console.warn('[HookPipeline] Shell command blocked', {
+                        agent: ctx.agentName,
+                        tool: ctx.toolName,
+                        command,
+                        blockedPattern: blocked,
+                    });
+                    return {
+                        action: 'block',
+                        reason: `Shell command blocked: Command contains prohibited pattern "${blocked}". Blocked commands: ${blockedCommands.join(', ')}`,
+                    };
+                }
+            }
+            return { action: 'allow' };
+        };
+    }
+    /** Create ask_user rate limiter hook */
+    createAskUserRateLimiter(maxCalls) {
+        return (ctx) => {
+            if (ctx.toolName !== 'ask_user') {
+                return { action: 'allow' };
+            }
+            const currentCount = this.askUserCallCount.get(ctx.sessionId) || 0;
+            if (currentCount >= maxCalls) {
+                console.warn('[HookPipeline] ask_user rate limit exceeded', {
+                    agent: ctx.agentName,
+                    sessionId: ctx.sessionId,
+                    currentCount,
+                    maxCalls,
+                });
+                return {
+                    action: 'block',
+                    reason: `ask_user rate limit exceeded: ${currentCount}/${maxCalls} calls used for this session. The agent should proceed without user input.`,
+                };
+            }
+            this.askUserCallCount.set(ctx.sessionId, currentCount + 1);
+            return { action: 'allow' };
+        };
+    }
+    /** Create PII scrubbing hook */
+    createPiiScrubber() {
+        const emailRegex = /[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}/g;
+        return (ctx) => {
+            let result = ctx.result;
+            if (typeof result === 'string') {
+                const scrubbed = result.replace(emailRegex, '[EMAIL_REDACTED]');
+                if (scrubbed !== result) {
+                    console.warn('[HookPipeline] PII scrubbed from tool output', {
+                        tool: ctx.toolName,
+                        agent: ctx.agentName,
+                        sessionId: ctx.sessionId,
+                    });
+                    result = scrubbed;
+                }
+            }
+            else if (result && typeof result === 'object') {
+                result = this.scrubObjectRecursive(result, emailRegex);
+            }
+            return { result };
+        };
+    }
+    /** Recursively scrub PII from object */
+    scrubObjectRecursive(obj, regex) {
+        if (typeof obj === 'string') {
+            return obj.replace(regex, '[EMAIL_REDACTED]');
+        }
+        if (Array.isArray(obj)) {
+            return obj.map(item => this.scrubObjectRecursive(item, regex));
+        }
+        if (obj && typeof obj === 'object') {
+            const scrubbed = {};
+            for (const [key, value] of Object.entries(obj)) {
+                scrubbed[key] = this.scrubObjectRecursive(value, regex);
+            }
+            return scrubbed;
+        }
+        return obj;
+    }
+    /** Simple glob matcher (supports * and **) */
+    matchGlob(path, pattern) {
+        // Normalize path separators
+        const normalizedPath = path.replace(/\\/g, '/');
+        const normalizedPattern = pattern.replace(/\\/g, '/');
+        // Convert glob pattern to regex (escape . first, then handle wildcards)
+        let regexPattern = normalizedPattern
+            .replace(/\./g, '\\.') // Escape literal dots first
+            .replace(/\*\*/g, '___DOUBLESTAR___') // Placeholder for **
+            .replace(/\*/g, '[^/]*') // Single * matches within path segment
+            .replace(/___DOUBLESTAR___/g, '.*') // ** matches across segments
+            .replace(/\?/g, '.'); // ? matches single char
+        const regex = new RegExp(`^${regexPattern}$`);
+        return regex.test(normalizedPath);
+    }
+    /** Get the reviewer lockout hook instance */
+    getReviewerLockout() {
+        return this.reviewerLockout;
+    }
+}
+// --- Reviewer Lockout Hook ---
+export class ReviewerLockoutHook {
+    lockoutRegistry = new Map();
+    /** Lock out an agent from an artifact */
+    lockout(artifactId, agentName) {
+        if (!this.lockoutRegistry.has(artifactId)) {
+            this.lockoutRegistry.set(artifactId, new Set());
+        }
+        this.lockoutRegistry.get(artifactId).add(agentName);
+    }
+    /** Check if an agent is locked out of an artifact */
+    isLockedOut(artifactId, agentName) {
+        const lockedAgents = this.lockoutRegistry.get(artifactId);
+        return lockedAgents ? lockedAgents.has(agentName) : false;
+    }
+    /** Clear lockout for an artifact */
+    clearLockout(artifactId) {
+        this.lockoutRegistry.delete(artifactId);
+    }
+    /** Get all lockouts for an artifact */
+    getLockedAgents(artifactId) {
+        const lockedAgents = this.lockoutRegistry.get(artifactId);
+        return lockedAgents ? Array.from(lockedAgents) : [];
+    }
+    /** Clear all lockouts */
+    clearAll() {
+        this.lockoutRegistry.clear();
+    }
+    /** Create pre-tool-use hook for reviewer lockout */
+    createHook() {
+        return (ctx) => {
+            const writeTools = ['edit', 'create', 'write_file', 'create_file'];
+            if (!writeTools.includes(ctx.toolName)) {
+                return { action: 'allow' };
+            }
+            const filePath = ctx.arguments.path || ctx.arguments.file_path;
+            if (!filePath || typeof filePath !== 'string') {
+                return { action: 'allow' };
+            }
+            // Check all artifacts to see if this agent is locked out
+            for (const [artifactId, lockedAgents] of this.lockoutRegistry.entries()) {
+                if (lockedAgents.has(ctx.agentName)) {
+                    // Agent is locked out of this artifact — check if file belongs to it
+                    // Simple heuristic: artifact ID is typically a file path or pattern
+                    if (filePath.includes(artifactId) || artifactId.includes(filePath)) {
+                        console.warn('[HookPipeline] Reviewer lockout triggered', {
+                            agent: ctx.agentName,
+                            artifactId,
+                            filePath,
+                        });
+                        return {
+                            action: 'block',
+                            reason: `Reviewer lockout: Agent "${ctx.agentName}" is locked out of artifact "${artifactId}". Another reviewer must handle this artifact.`,
+                        };
+                    }
+                }
+            }
+            return { action: 'allow' };
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

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

package/dist/index.d.ts

@@ -1,2 +1,25 @@
-export declare const VERSION = "0.6.0-alpha.0";
+/**
+ * Squad SDK — Public API barrel export.
+ * This module has ZERO side effects. Safe to import as a library.
+ * CLI entry point lives in src/cli-entry.ts.
+ */
+export declare const VERSION = "0.8.0";
+export { resolveSquad, resolveGlobalSquadPath, ensureSquadPath } from './resolution.js';
+export * from './config/index.js';
+export * from './agents/onboarding.js';
+export * from './casting/index.js';
+export * from './skills/index.js';
+export { selectResponseTier, getTier } from './coordinator/response-tiers.js';
+export type { ResponseTier, TierName, TierContext, ModelTierSuggestion } from './coordinator/response-tiers.js';
+export { loadConfig, loadConfigSync } from './runtime/config.js';
+export type { ConfigLoadResult, ConfigValidationError } from './runtime/config.js';
+export * from './runtime/streaming.js';
+export * from './runtime/cost-tracker.js';
+export * from './runtime/telemetry.js';
+export * from './runtime/offline.js';
+export * from './runtime/i18n.js';
+export * from './runtime/benchmarks.js';
+export * from './marketplace/index.js';
+export * from './build/index.js';
+export * from './sharing/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,OAAO,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACxF,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAC9E,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAChH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACjE,YAAY,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACnF,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AAExC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC"}