swarm-engine 1.0.0

package/dist/utils/project-config.js

@@ -0,0 +1,46 @@
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import yaml from 'js-yaml';
+export function loadProjectConfig(cwd) {
+    const dir = cwd ?? process.cwd();
+    const candidates = [
+        join(dir, '.swarm.yml'),
+        join(dir, '.swarm.yaml'),
+        join(dir, '.swarm', 'config.yml'),
+    ];
+    for (const path of candidates) {
+        if (existsSync(path)) {
+            try {
+                const content = readFileSync(path, 'utf-8');
+                const parsed = yaml.load(content, { schema: yaml.DEFAULT_SCHEMA });
+                if (parsed && typeof parsed === 'object') {
+                    return parsed;
+                }
+            }
+            catch {
+                return null;
+            }
+        }
+    }
+    return null;
+}
+export function getProjectName(cwd) {
+    // Try .swarm.yml first
+    const config = loadProjectConfig(cwd);
+    if (config?.project)
+        return config.project;
+    // Try package.json
+    const dir = cwd ?? process.cwd();
+    const pkgPath = join(dir, 'package.json');
+    if (existsSync(pkgPath)) {
+        try {
+            const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+            if (pkg.name)
+                return pkg.name;
+        }
+        catch { }
+    }
+    // Fall back to directory name
+    return dir.split('/').pop() ?? null;
+}
+//# sourceMappingURL=project-config.js.map

package/dist/utils/project-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-config.js","sourceRoot":"","sources":["../../src/utils/project-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,IAAI,MAAM,SAAS,CAAC;AAkB3B,MAAM,UAAU,iBAAiB,CAAC,GAAY;IAC5C,MAAM,GAAG,GAAG,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACjC,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC;QACvB,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC;QACxB,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,YAAY,CAAC;KAClC,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;gBACnE,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;oBACzC,OAAO,MAAuB,CAAC;gBACjC,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,uBAAuB;IACvB,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,MAAM,EAAE,OAAO;QAAE,OAAO,MAAM,CAAC,OAAO,CAAC;IAE3C,mBAAmB;IACnB,MAAM,GAAG,GAAG,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACjC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAC1C,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;YACvD,IAAI,GAAG,CAAC,IAAI;gBAAE,OAAO,GAAG,CAAC,IAAI,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;IAED,8BAA8B;IAC9B,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC;AACtC,CAAC"}

package/dist/utils/redact.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Secret redaction utility — strips credentials from text before storage.
+ */
+export declare function redactSecrets(text: string): string;
+//# sourceMappingURL=redact.d.ts.map

package/dist/utils/redact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../src/utils/redact.ts"],"names":[],"mappings":"AAAA;;GAEG;AAiBH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMlD"}

package/dist/utils/redact.js

@@ -0,0 +1,25 @@
+/**
+ * Secret redaction utility — strips credentials from text before storage.
+ */
+const SECRET_PATTERNS = [
+    /(?:password|passwd|pwd)\s*[:=]\s*(?:"[^"]*"|'[^']*'|[^\s"']+)/gi,
+    /(?:api[_-]?key|apikey)\s*[:=]\s*(?:"[^"]*"|'[^']*'|[^\s"']+)/gi,
+    /(?:secret|token)\s*[:=]\s*(?:"[^"]*"|'[^']*'|[^\s"']+)/gi,
+    /(?:postgres|mysql|mongodb|redis):\/\/[^\s"']+/gi,
+    /(?:mongodb\+srv|rediss?|amqps?):\/\/[^\s"']+/gi,
+    /sk-[a-zA-Z0-9]{20,}/g,
+    /ghp_[a-zA-Z0-9]{36}/g,
+    /github_pat_[a-zA-Z0-9_]{22,}/g,
+    /AKIA[0-9A-Z]{16}/g,
+    /-----BEGIN[A-Z ]*PRIVATE KEY-----/g,
+    /Bearer\s+[^\s"']+/gi,
+    /Authorization:\s*Basic\s+[^\s"']+/gi,
+];
+export function redactSecrets(text) {
+    let result = text;
+    for (const pattern of SECRET_PATTERNS) {
+        result = result.replace(pattern, '[REDACTED]');
+    }
+    return result;
+}
+//# sourceMappingURL=redact.js.map

package/dist/utils/redact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.js","sourceRoot":"","sources":["../../src/utils/redact.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,eAAe,GAAG;IACtB,iEAAiE;IACjE,gEAAgE;IAChE,0DAA0D;IAC1D,iDAAiD;IACjD,gDAAgD;IAChD,sBAAsB;IACtB,sBAAsB;IACtB,+BAA+B;IAC/B,mBAAmB;IACnB,oCAAoC;IACpC,qBAAqB;IACrB,qCAAqC;CACtC,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,KAAK,MAAM,OAAO,IAAI,eAAe,EAAE,CAAC;QACtC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/utils/schemas.d.ts

@@ -0,0 +1,109 @@
+import { z } from 'zod';
+export declare const ModelTierSchema: z.ZodDefault<z.ZodEnum<{
+    haiku: "haiku";
+    sonnet: "sonnet";
+    opus: "opus";
+}>>;
+export declare const PermissionProfileSchema: z.ZodOptional<z.ZodEnum<{
+    safe: "safe";
+    standard: "standard";
+    trusted: "trusted";
+}>>;
+export declare const PromptTierSchema: z.ZodOptional<z.ZodEnum<{
+    full: "full";
+    lite: "lite";
+    minimal: "minimal";
+}>>;
+export declare const OutputFormatSchema: z.ZodOptional<z.ZodEnum<{
+    free: "free";
+    structured: "structured";
+}>>;
+export declare const AgentFrontmatterSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodDefault<z.ZodString>;
+    model: z.ZodDefault<z.ZodEnum<{
+        haiku: "haiku";
+        sonnet: "sonnet";
+        opus: "opus";
+    }>>;
+    backend: z.ZodOptional<z.ZodString>;
+    backendModel: z.ZodOptional<z.ZodString>;
+    extends: z.ZodOptional<z.ZodString>;
+    tools: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodPipe<z.ZodString, z.ZodTransform<string[], string>>]>>;
+    disallowedTools: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodPipe<z.ZodString, z.ZodTransform<string[], string>>]>>;
+    maxTurns: z.ZodOptional<z.ZodNumber>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    costBudget: z.ZodOptional<z.ZodNumber>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    permissionProfile: z.ZodOptional<z.ZodEnum<{
+        safe: "safe";
+        standard: "standard";
+        trusted: "trusted";
+    }>>;
+    promptTier: z.ZodOptional<z.ZodEnum<{
+        full: "full";
+        lite: "lite";
+        minimal: "minimal";
+    }>>;
+    outputFormat: z.ZodOptional<z.ZodEnum<{
+        free: "free";
+        structured: "structured";
+    }>>;
+    mcp: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    worktree: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$loose>;
+export declare const TemplateParameterSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        string: "string";
+        number: "number";
+        boolean: "boolean";
+    }>;
+    description: z.ZodString;
+    required: z.ZodDefault<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodUnknown>;
+    enum: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    example: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const TemplateAgentOverrideSchema: z.ZodObject<{
+    extra_rules: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    model: z.ZodOptional<z.ZodString>;
+    backend: z.ZodOptional<z.ZodString>;
+    permissionProfile: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const TemplateVerificationSchema: z.ZodObject<{
+    name: z.ZodString;
+    command: z.ZodString;
+    optional: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const TemplateConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    parameters: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        type: z.ZodEnum<{
+            string: "string";
+            number: "number";
+            boolean: "boolean";
+        }>;
+        description: z.ZodString;
+        required: z.ZodDefault<z.ZodBoolean>;
+        default: z.ZodOptional<z.ZodUnknown>;
+        enum: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        example: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    pattern: z.ZodString;
+    context_files: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    agents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        extra_rules: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        model: z.ZodOptional<z.ZodString>;
+        backend: z.ZodOptional<z.ZodString>;
+        permissionProfile: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    verification: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        command: z.ZodString;
+        optional: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    success_criteria: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$loose>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/utils/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/utils/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,eAAe;;;;GAAwD,CAAC;AAErF,eAAO,MAAM,uBAAuB;;;;GAAqD,CAAC;AAE1F,eAAO,MAAM,gBAAgB;;;;GAAiD,CAAC;AAE/E,eAAO,MAAM,kBAAkB;;;GAA4C,CAAC;AAE5E,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAwBnB,CAAC;AAIjB,eAAO,MAAM,uBAAuB;;;;;;;;;;;iBAOlC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;iBAKtC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;iBAIrC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAUjB,CAAC"}

package/dist/utils/schemas.js

@@ -0,0 +1,63 @@
+import { z } from 'zod';
+// ─── Agent Schema ─────────────────────────────────────────────
+export const ModelTierSchema = z.enum(['haiku', 'sonnet', 'opus']).default('sonnet');
+export const PermissionProfileSchema = z.enum(['safe', 'standard', 'trusted']).optional();
+export const PromptTierSchema = z.enum(['full', 'lite', 'minimal']).optional();
+export const OutputFormatSchema = z.enum(['free', 'structured']).optional();
+export const AgentFrontmatterSchema = z.object({
+    name: z.string().min(1, 'Agent name is required'),
+    description: z.string().default(''),
+    model: ModelTierSchema,
+    backend: z.string().optional(),
+    backendModel: z.string().optional(),
+    extends: z.string().optional(),
+    tools: z.union([
+        z.array(z.string()),
+        z.string().transform(s => s.split(',').map(t => t.trim())),
+    ]).optional(),
+    disallowedTools: z.union([
+        z.array(z.string()),
+        z.string().transform(s => s.split(',').map(t => t.trim())),
+    ]).optional(),
+    maxTurns: z.number().positive().optional(),
+    timeout: z.number().positive().optional(),
+    costBudget: z.number().positive().optional(),
+    tags: z.array(z.string()).default([]),
+    permissionProfile: PermissionProfileSchema,
+    promptTier: PromptTierSchema,
+    outputFormat: OutputFormatSchema,
+    mcp: z.array(z.string()).optional(),
+    worktree: z.boolean().optional(),
+}).passthrough(); // Allow unknown fields for forward compatibility
+// ─── Template Schema ──────────────────────────────────────────
+export const TemplateParameterSchema = z.object({
+    type: z.enum(['string', 'number', 'boolean']),
+    description: z.string(),
+    required: z.boolean().default(true),
+    default: z.unknown().optional(),
+    enum: z.array(z.string()).optional(),
+    example: z.string().optional(),
+});
+export const TemplateAgentOverrideSchema = z.object({
+    extra_rules: z.array(z.string()).optional(),
+    model: z.string().optional(),
+    backend: z.string().optional(),
+    permissionProfile: z.string().optional(),
+});
+export const TemplateVerificationSchema = z.object({
+    name: z.string(),
+    command: z.string(),
+    optional: z.boolean().default(false),
+});
+export const TemplateConfigSchema = z.object({
+    name: z.string().min(1, 'Template name is required'),
+    description: z.string(),
+    parameters: z.record(z.string(), TemplateParameterSchema).default({}),
+    pattern: z.string().min(1, 'Pattern is required'),
+    context_files: z.array(z.string()).optional(),
+    agents: z.record(z.string(), TemplateAgentOverrideSchema).optional(),
+    verification: z.array(TemplateVerificationSchema).optional(),
+    success_criteria: z.array(z.string()).optional(),
+    tags: z.array(z.string()).optional(),
+}).passthrough();
+//# sourceMappingURL=schemas.js.map

package/dist/utils/schemas.js.map

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

package/dist/utils/terminal.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Terminal capability detection.
+ * Works on macOS, Linux, Windows Terminal, tmux, etc.
+ */
+export type TerminalType = 'iterm2' | 'ghostty' | 'wezterm' | 'windows-terminal' | 'tmux' | 'generic';
+export declare function detectTerminal(): TerminalType;
+/**
+ * Set terminal/pane title — works in most terminals.
+ */
+export declare function setTitle(title: string): void;
+/**
+ * Reset terminal title.
+ */
+export declare function resetTitle(): void;
+/**
+ * Check if terminal supports colors.
+ */
+export declare function supportsColor(): boolean;
+/**
+ * Check if we're running in a CI environment.
+ */
+export declare function isCI(): boolean;
+/**
+ * Platform detection.
+ */
+export declare function isMacOS(): boolean;
+export declare function isLinux(): boolean;
+export declare function isWindows(): boolean;
+/**
+ * Send a desktop notification (cross-platform).
+ */
+export declare function notify(title: string, message: string): Promise<void>;
+//# sourceMappingURL=terminal.d.ts.map

package/dist/utils/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../src/utils/terminal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,kBAAkB,GAAG,MAAM,GAAG,SAAS,CAAC;AAEtG,wBAAgB,cAAc,IAAI,YAAY,CAU7C;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAK5C;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAEjC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAIvC;AAED;;GAEG;AACH,wBAAgB,IAAI,IAAI,OAAO,CAE9B;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,OAAO,CAA0C;AAC5E,wBAAgB,OAAO,IAAI,OAAO,CAAyC;AAC3E,wBAAgB,SAAS,IAAI,OAAO,CAAyC;AAE7E;;GAEG;AACH,wBAAsB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB1E"}

package/dist/utils/terminal.js

@@ -0,0 +1,82 @@
+/**
+ * Terminal capability detection.
+ * Works on macOS, Linux, Windows Terminal, tmux, etc.
+ */
+export function detectTerminal() {
+    const termProgram = process.env.TERM_PROGRAM?.toLowerCase() ?? '';
+    const wtSession = process.env.WT_SESSION;
+    if (termProgram.includes('iterm'))
+        return 'iterm2';
+    if (termProgram.includes('ghostty'))
+        return 'ghostty';
+    if (termProgram.includes('wezterm'))
+        return 'wezterm';
+    if (wtSession)
+        return 'windows-terminal';
+    if (process.env.TMUX)
+        return 'tmux';
+    return 'generic';
+}
+/**
+ * Set terminal/pane title — works in most terminals.
+ */
+export function setTitle(title) {
+    // Strip control characters to prevent escape sequence injection
+    const safe = title.replace(/[\x00-\x1f\x7f]/g, '');
+    // OSC 0 — Set window/tab title (universal)
+    process.stdout.write(`\x1b]0;${safe}\x07`);
+}
+/**
+ * Reset terminal title.
+ */
+export function resetTitle() {
+    process.stdout.write(`\x1b]0;\x07`);
+}
+/**
+ * Check if terminal supports colors.
+ */
+export function supportsColor() {
+    if (process.env.NO_COLOR)
+        return false;
+    if (process.env.FORCE_COLOR)
+        return true;
+    return process.stdout.isTTY ?? false;
+}
+/**
+ * Check if we're running in a CI environment.
+ */
+export function isCI() {
+    return !!(process.env.CI || process.env.GITHUB_ACTIONS || process.env.GITLAB_CI || process.env.JENKINS_URL);
+}
+/**
+ * Platform detection.
+ */
+export function isMacOS() { return process.platform === 'darwin'; }
+export function isLinux() { return process.platform === 'linux'; }
+export function isWindows() { return process.platform === 'win32'; }
+/**
+ * Send a desktop notification (cross-platform).
+ */
+export async function notify(title, message) {
+    const { execFile } = await import('child_process');
+    const { promisify } = await import('util');
+    const execFileAsync = promisify(execFile);
+    try {
+        if (isMacOS()) {
+            // Use execFile with argument array — prevents shell injection
+            await execFileAsync('osascript', [
+                '-e', 'on run argv',
+                '-e', 'display notification (item 1 of argv) with title (item 2 of argv)',
+                '-e', 'end run',
+                '--', message, title,
+            ]);
+        }
+        else if (isLinux()) {
+            await execFileAsync('notify-send', [title, message]);
+        }
+    }
+    catch {
+        // Silent fail — notifications are optional
+    }
+}
+//# sourceMappingURL=terminal.js.map

package/dist/utils/terminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.js","sourceRoot":"","sources":["../../src/utils/terminal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,UAAU,cAAc;IAC5B,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAClE,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;IAEzC,IAAI,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,QAAQ,CAAC;IACnD,IAAI,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IACtD,IAAI,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IACtD,IAAI,SAAS;QAAE,OAAO,kBAAkB,CAAC;IACzC,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI;QAAE,OAAO,MAAM,CAAC;IACpC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,gEAAgE;IAChE,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;IACnD,2CAA2C;IAC3C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,IAAI,MAAM,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IACvC,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,KAAK,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,IAAI;IAClB,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AAC9G,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,KAAc,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC;AAC5E,MAAM,UAAU,OAAO,KAAc,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC;AAC3E,MAAM,UAAU,SAAS,KAAc,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC;AAE7E;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,KAAa,EAAE,OAAe;IACzD,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;IACnD,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAE1C,IAAI,CAAC;QACH,IAAI,OAAO,EAAE,EAAE,CAAC;YACd,8DAA8D;YAC9D,MAAM,aAAa,CAAC,WAAW,EAAE;gBAC/B,IAAI,EAAE,aAAa;gBACnB,IAAI,EAAE,mEAAmE;gBACzE,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,OAAO,EAAE,KAAK;aACrB,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,OAAO,EAAE,EAAE,CAAC;YACrB,MAAM,aAAa,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,2CAA2C;IAC7C,CAAC;AACH,CAAC"}

package/dist/utils/tokens.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Estimate token count from text.
+ *
+ * Uses ~4 chars per token as a rough approximation.
+ * This is intentionally simple — replace with a proper tokenizer
+ * (e.g., tiktoken) if precise counts are needed for budget enforcement.
+ */
+export declare function estimateTokens(text: string): number;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/utils/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/utils/tokens.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/utils/tokens.js

@@ -0,0 +1,11 @@
+/**
+ * Estimate token count from text.
+ *
+ * Uses ~4 chars per token as a rough approximation.
+ * This is intentionally simple — replace with a proper tokenizer
+ * (e.g., tiktoken) if precise counts are needed for budget enforcement.
+ */
+export function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+//# sourceMappingURL=tokens.js.map

package/dist/utils/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/utils/tokens.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "swarm-engine",
+  "version": "1.0.0",
+  "description": "Multi-agent orchestration for AI coding tools — your agents, orchestrated",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "swarm": "dist/cli/bin.js",
+    "swarm-engine": "dist/cli/bin.js"
+  },
+  "files": [
+    "dist/",
+    "agents/",
+    "commands/",
+    "skills/",
+    "templates/",
+    "AGENTS.md",
+    "CLAUDE.md",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/cli/index.ts",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "lint": "tsc --noEmit",
+    "start": "node dist/cli/index.js",
+    "prepublishOnly": "npm run build",
+    "postinstall": "node -e \"console.log('\\n  swarm-engine installed! Run: swarm doctor\\n')\" 2>/dev/null || true"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.2.90",
+    "better-sqlite3": "^12.8.0",
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "js-yaml": "^4.1.1"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "multi-agent",
+    "orchestration",
+    "claude",
+    "codex",
+    "gemini",
+    "swarm",
+    "coding",
+    "developer-tools"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/simoncoombes/swarm-engine.git"
+  },
+  "homepage": "https://github.com/simoncoombes/swarm-engine",
+  "bugs": "https://github.com/simoncoombes/swarm-engine/issues",
+  "license": "MIT",
+  "author": "Simon Coombes <simon@unstructured.io>"
+}