sandstream-kit 1.0.0

package/dist/agent-adapter-service.js

@@ -0,0 +1,299 @@
+import { randomUUID } from "node:crypto";
+const adapters = new Map();
+const capabilities = new Map();
+const introspections = new Map();
+const automations = new Map();
+const collaborations = new Map();
+// Predefined agent profiles
+const AGENT_PROFILES = {
+    claude: {
+        id: `profile_claude_${randomUUID()}`,
+        agent_type: "claude",
+        version: "4.5",
+        name: "Claude AI",
+        description: "Claude LLM with extended file access and debugging capabilities",
+        capabilities: [
+            "file_read",
+            "file_write",
+            "code_execution",
+            "debugging",
+            "testing",
+            "ai_collaboration",
+            "context_management",
+        ],
+        config_required: ["api_key"],
+        optional_config: ["model", "max_tokens", "temperature"],
+        installation_method: "cli",
+        homepage: "https://claude.ai",
+        documentation: "https://docs.anthropic.com",
+        created_at: new Date().toISOString(),
+        updated_at: new Date().toISOString(),
+    },
+    cursor: {
+        id: `profile_cursor_${randomUUID()}`,
+        agent_type: "cursor",
+        version: "0.40",
+        name: "Cursor Editor",
+        description: "Cursor IDE with AI-powered code editing and workspace awareness",
+        capabilities: [
+            "file_read",
+            "file_write",
+            "code_execution",
+            "git_integration",
+            "debugging",
+            "testing",
+            "workspace_awareness",
+            "ai_collaboration",
+        ],
+        config_required: ["editor_path", "project_root"],
+        optional_config: ["git_branch", "excluded_paths"],
+        installation_method: "extension",
+        homepage: "https://cursor.sh",
+        documentation: "https://cursor.sh/docs",
+        created_at: new Date().toISOString(),
+        updated_at: new Date().toISOString(),
+    },
+    cline: {
+        id: `profile_cline_${randomUUID()}`,
+        agent_type: "cline",
+        version: "2.0",
+        name: "Cline AI Assistant",
+        description: "Cline with autonomous task execution and terminal access",
+        capabilities: [
+            "file_read",
+            "file_write",
+            "code_execution",
+            "terminal_access",
+            "git_integration",
+            "testing",
+        ],
+        config_required: ["agent_key"],
+        optional_config: ["allowed_commands", "max_execution_time"],
+        installation_method: "cli",
+        homepage: "https://cline.dev",
+        documentation: "https://cline.dev/docs",
+        created_at: new Date().toISOString(),
+        updated_at: new Date().toISOString(),
+    },
+    generic: {
+        id: `profile_generic_${randomUUID()}`,
+        agent_type: "generic",
+        version: "1.0",
+        name: "Generic Agent",
+        description: "Generic adapter for custom agents",
+        capabilities: ["file_read", "ai_collaboration", "context_management"],
+        config_required: ["agent_id"],
+        optional_config: ["custom_config"],
+        installation_method: "manual",
+        created_at: new Date().toISOString(),
+        updated_at: new Date().toISOString(),
+    },
+};
+/**
+ * Register agent adapter for team
+ */
+export function registerAgentAdapter(team_id, agent_type, config) {
+    const profile = AGENT_PROFILES[agent_type];
+    if (!profile) {
+        return { adapter: {}, error: `Unknown agent type: ${agent_type}` };
+    }
+    // Validate required config
+    const missing = profile.config_required.filter((key) => !(key in config));
+    if (missing.length > 0) {
+        return {
+            adapter: {},
+            error: `Missing required config: ${missing.join(", ")}`,
+        };
+    }
+    const adapter = {
+        id: `adapter_${randomUUID()}`,
+        team_id,
+        agent_type,
+        agent_profile_id: profile.id,
+        status: "installed",
+        version: profile.version,
+        installed_at: new Date().toISOString(),
+        config,
+        enabled_capabilities: profile.capabilities,
+        disabled_capabilities: [],
+        health_status: "healthy",
+        last_health_check: new Date().toISOString(),
+        created_at: new Date().toISOString(),
+        updated_at: new Date().toISOString(),
+    };
+    adapters.set(adapter.id, adapter);
+    // Create capability records
+    for (const cap of profile.capabilities) {
+        const capability = {
+            id: `cap_${randomUUID()}`,
+            adapter_id: adapter.id,
+            team_id,
+            capability_type: cap,
+            enabled: true,
+            required_config: {},
+            permissions_required: [],
+            usage_count: 0,
+            created_at: new Date().toISOString(),
+            updated_at: new Date().toISOString(),
+        };
+        capabilities.set(capability.id, capability);
+    }
+    return { adapter };
+}
+/**
+ * Get agent adapter status
+ */
+export function getAdapterStatus(team_id, adapter_id) {
+    const adapter = adapters.get(adapter_id);
+    if (!adapter || adapter.team_id !== team_id) {
+        return { adapter: null, error: "Adapter not found" };
+    }
+    return { adapter };
+}
+/**
+ * Check agent capabilities
+ */
+export function checkCapabilities(team_id, adapter_id) {
+    const teamCaps = Array.from(capabilities.values()).filter((c) => c.adapter_id === adapter_id && c.team_id === team_id);
+    const enabledCount = teamCaps.filter((c) => c.enabled).length;
+    const coverage = teamCaps.length > 0 ? (enabledCount / teamCaps.length) * 100 : 0;
+    return { capabilities: teamCaps, coverage_percent: Math.round(coverage) };
+}
+/**
+ * Enable/disable capability
+ */
+export function toggleCapability(team_id, capability_id, enabled) {
+    const capability = capabilities.get(capability_id);
+    if (!capability || capability.team_id !== team_id) {
+        return { capability: {}, error: "Capability not found" };
+    }
+    capability.enabled = enabled;
+    capability.updated_at = new Date().toISOString();
+    return { capability };
+}
+/**
+ * Introspect agent state
+ */
+export function introspectAgent(team_id, adapter_id, introspection_type) {
+    const adapter = adapters.get(adapter_id);
+    if (!adapter || adapter.team_id !== team_id) {
+        return { introspection: {}, error: "Adapter not found" };
+    }
+    const introspection = {
+        id: `intro_${randomUUID()}`,
+        team_id,
+        adapter_id,
+        introspection_type: introspection_type,
+        data: {
+            agent_type: adapter.agent_type,
+            status: adapter.status,
+            health: adapter.health_status,
+            capabilities_enabled: adapter.enabled_capabilities.length,
+            config_keys: Object.keys(adapter.config),
+        },
+        timestamp: new Date().toISOString(),
+        ttl_seconds: 300,
+    };
+    introspections.set(introspection.id, introspection);
+    return { introspection };
+}
+/**
+ * Create agent automation
+ */
+export function createAutomation(team_id, adapter_id, automation_name, trigger, actions) {
+    const adapter = adapters.get(adapter_id);
+    if (!adapter || adapter.team_id !== team_id) {
+        return { automation: {}, error: "Adapter not found" };
+    }
+    const automation = {
+        id: `auto_${randomUUID()}`,
+        team_id,
+        adapter_id,
+        automation_name,
+        trigger,
+        actions,
+        enabled: true,
+        run_count: 0,
+        error_count: 0,
+        created_at: new Date().toISOString(),
+        updated_at: new Date().toISOString(),
+    };
+    automations.set(automation.id, automation);
+    return { automation };
+}
+/**
+ * Setup agent collaboration
+ */
+export function setupCollaboration(team_id, agent_adapter_ids, collaboration_mode, shared_context) {
+    // Validate all adapters exist
+    const adaptersExist = agent_adapter_ids.every((id) => {
+        const a = adapters.get(id);
+        return a && a.team_id === team_id;
+    });
+    if (!adaptersExist) {
+        return { collaboration: {}, error: "Some adapters not found" };
+    }
+    const collaboration = {
+        id: `collab_${randomUUID()}`,
+        team_id,
+        collaboration_id: `collab_${randomUUID()}`,
+        agents: agent_adapter_ids.map((adapter_id, idx) => {
+            const a = adapters.get(adapter_id);
+            return {
+                adapter_id,
+                agent_type: a.agent_type,
+                role: idx === 0 ? "primary" : idx === agent_adapter_ids.length - 1 ? "observer" : "secondary",
+            };
+        }),
+        mode: collaboration_mode,
+        shared_context: shared_context || {},
+        status: "active",
+        created_at: new Date().toISOString(),
+        updated_at: new Date().toISOString(),
+    };
+    collaborations.set(collaboration.id, collaboration);
+    return { collaboration };
+}
+/**
+ * Get agent metrics
+ */
+export function getAdapterMetrics(team_id, adapter_id) {
+    const adapter = adapters.get(adapter_id) || {};
+    const teamCaps = Array.from(capabilities.values()).filter((c) => c.adapter_id === adapter_id && c.team_id === team_id);
+    const enabledCaps = teamCaps.filter((c) => c.enabled).length;
+    const teamAutomations = Array.from(automations.values()).filter((a) => a.adapter_id === adapter_id && a.team_id === team_id);
+    const activeAutomations = teamAutomations.filter((a) => a.enabled).length;
+    const teamCollaborations = Array.from(collaborations.values()).filter((c) => c.team_id === team_id && c.agents.some((a) => a.adapter_id === adapter_id));
+    const activeCollaborations = teamCollaborations.filter((c) => c.status === "active").length;
+    return {
+        adapter_id,
+        agent_type: adapter.agent_type || "generic",
+        health_score: adapter.health_status === "healthy" ? 95 : adapter.health_status === "degraded" ? 60 : 20,
+        uptime_percent: 99.5,
+        capability_coverage: teamCaps.length > 0 ? Math.round((enabledCaps / teamCaps.length) * 100) : 0,
+        average_latency_ms: 150,
+        error_rate_percent: 0.5,
+        last_activity: adapter.updated_at || new Date().toISOString(),
+        collaborations_active: activeCollaborations,
+        automations_active: activeAutomations,
+        operations_today: 42,
+    };
+}
+/**
+ * List team agents
+ */
+export function listTeamAdapters(team_id) {
+    const teamAdapters = Array.from(adapters.values()).filter((a) => a.team_id === team_id);
+    return { adapters: teamAdapters };
+}
+/**
+ * Get collaboration status
+ */
+export function getCollaborationStatus(team_id, collaboration_id) {
+    const collab = collaborations.get(collaboration_id);
+    if (!collab || collab.team_id !== team_id) {
+        return { collaboration: null, error: "Collaboration not found" };
+    }
+    return { collaboration: collab };
+}
+//# sourceMappingURL=agent-adapter-service.js.map

package/dist/agent-adapter-service.js.map

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

package/dist/agent-config.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Teach the coding agent to use kit.
+ *
+ * `kit setup` only writes `.kit.toml` — it does not tell Claude Code / Codex /
+ * Cursor / Cline to actually *run* kit. This module injects a small, managed
+ * instruction block into the agent's rules file so the agent runs `kit check`,
+ * triages dependencies before install, and resolves secrets via the vault.
+ *
+ * Safety: this only writes plain text the agent reads — it never registers an
+ * executable hook (that's a separate, more invasive opt-in). The block is
+ * delimited by BEGIN/END markers and is idempotent: re-running updates the
+ * block in place and never touches anything outside the markers.
+ */
+export declare const KIT_BLOCK_BEGIN = "<!-- BEGIN kit (managed block \u2014 edit outside the markers, not inside) -->";
+export declare const KIT_BLOCK_END = "<!-- END kit -->";
+/** The canonical "use kit" instruction. Kept short on purpose — agents read it
+ *  every turn, so it states the rules, not the rationale. */
+export declare const KIT_INSTRUCTION = "## kit\n\nThis project uses [kit](https://github.com/sandstream/kit) to manage tools, secrets, and environment setup. As the agent working here:\n\n- Run `kit check` before starting; if it reports `fail`, run `kit fix` then re-check.\n- Before installing ANY dependency, run `kit triage npm|pip|docker|repo <target>` and only install if it passes.\n- Never write secrets to `.env*` in plaintext \u2014 resolve them with `kit secrets` (vault-backed).\n- After a batch of edits, run `kit check --category security`; halt and surface findings on `fail`.\n- Destructive secret ops require `kit auth elevate` first.";
+export interface AgentTarget {
+    /** Agent/tool name for display. */
+    agent: string;
+    /** Rules file, relative to project root. */
+    file: string;
+}
+/** Rules file per agent. CLAUDE.md / AGENTS.md are the common cross-tool ones;
+ *  Cursor and Cline read their own dotfiles. */
+export declare const AGENT_TARGETS: AgentTarget[];
+/**
+ * Which agents look present in this project. Presence = the rules file already
+ * exists OR a tool-specific marker dir/file is there. When nothing matches we
+ * fall back to the two portable defaults (CLAUDE.md + AGENTS.md) so a fresh
+ * project still gets wired.
+ */
+export declare function detectAgentTargets(cwd?: string): AgentTarget[];
+/**
+ * Insert or update the managed kit block in `content`. Pure string transform —
+ * no I/O — so it's trivially testable.
+ *
+ * - No existing block → append (with a blank-line separator if the file is non-empty).
+ * - Existing block → replace just the marker-delimited region, preserving everything else.
+ */
+export declare function upsertKitBlock(content: string): {
+    next: string;
+    action: "created" | "updated" | "unchanged";
+};
+export interface AgentConfigResult {
+    agent: string;
+    file: string;
+    action: "created" | "updated" | "unchanged" | "failed";
+    detail: string;
+}
+/**
+ * Write the managed kit block into each detected agent's rules file.
+ * Read-only mode refuses + audits before any write.
+ */
+export declare function writeAgentConfig(cwd?: string, targets?: AgentTarget[]): Promise<AgentConfigResult[]>;

package/dist/agent-config.js

@@ -0,0 +1,129 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+/**
+ * Teach the coding agent to use kit.
+ *
+ * `kit setup` only writes `.kit.toml` — it does not tell Claude Code / Codex /
+ * Cursor / Cline to actually *run* kit. This module injects a small, managed
+ * instruction block into the agent's rules file so the agent runs `kit check`,
+ * triages dependencies before install, and resolves secrets via the vault.
+ *
+ * Safety: this only writes plain text the agent reads — it never registers an
+ * executable hook (that's a separate, more invasive opt-in). The block is
+ * delimited by BEGIN/END markers and is idempotent: re-running updates the
+ * block in place and never touches anything outside the markers.
+ */
+export const KIT_BLOCK_BEGIN = "<!-- BEGIN kit (managed block — edit outside the markers, not inside) -->";
+export const KIT_BLOCK_END = "<!-- END kit -->";
+/** The canonical "use kit" instruction. Kept short on purpose — agents read it
+ *  every turn, so it states the rules, not the rationale. */
+export const KIT_INSTRUCTION = `## kit
+
+This project uses [kit](https://github.com/sandstream/kit) to manage tools, secrets, and environment setup. As the agent working here:
+
+- Run \`kit check\` before starting; if it reports \`fail\`, run \`kit fix\` then re-check.
+- Before installing ANY dependency, run \`kit triage npm|pip|docker|repo <target>\` and only install if it passes.
+- Never write secrets to \`.env*\` in plaintext — resolve them with \`kit secrets\` (vault-backed).
+- After a batch of edits, run \`kit check --category security\`; halt and surface findings on \`fail\`.
+- Destructive secret ops require \`kit auth elevate\` first.`;
+/** Rules file per agent. CLAUDE.md / AGENTS.md are the common cross-tool ones;
+ *  Cursor and Cline read their own dotfiles. */
+export const AGENT_TARGETS = [
+    { agent: "Claude Code", file: "CLAUDE.md" },
+    { agent: "Codex", file: "AGENTS.md" },
+    { agent: "Cursor", file: ".cursorrules" },
+    { agent: "Cline", file: ".clinerules" },
+];
+/**
+ * Which agents look present in this project. Presence = the rules file already
+ * exists OR a tool-specific marker dir/file is there. When nothing matches we
+ * fall back to the two portable defaults (CLAUDE.md + AGENTS.md) so a fresh
+ * project still gets wired.
+ */
+export function detectAgentTargets(cwd = process.cwd()) {
+    const present = AGENT_TARGETS.filter((t) => {
+        if (existsSync(resolve(cwd, t.file)))
+            return true;
+        switch (t.agent) {
+            case "Claude Code":
+                return existsSync(resolve(cwd, ".claude"));
+            case "Codex":
+                return existsSync(resolve(cwd, ".codex"));
+            case "Cursor":
+                return existsSync(resolve(cwd, ".cursor"));
+            default:
+                return false;
+        }
+    });
+    if (present.length > 0)
+        return present;
+    return AGENT_TARGETS.filter((t) => t.file === "CLAUDE.md" || t.file === "AGENTS.md");
+}
+/**
+ * Insert or update the managed kit block in `content`. Pure string transform —
+ * no I/O — so it's trivially testable.
+ *
+ * - No existing block → append (with a blank-line separator if the file is non-empty).
+ * - Existing block → replace just the marker-delimited region, preserving everything else.
+ */
+export function upsertKitBlock(content) {
+    const block = `${KIT_BLOCK_BEGIN}\n\n${KIT_INSTRUCTION}\n\n${KIT_BLOCK_END}`;
+    const begin = content.indexOf(KIT_BLOCK_BEGIN);
+    const end = content.indexOf(KIT_BLOCK_END);
+    if (begin !== -1 && end !== -1 && end > begin) {
+        const before = content.slice(0, begin);
+        const after = content.slice(end + KIT_BLOCK_END.length);
+        const next = before + block + after;
+        return { next, action: next === content ? "unchanged" : "updated" };
+    }
+    const sep = content.length === 0 ? "" : content.endsWith("\n\n") ? "" : content.endsWith("\n") ? "\n" : "\n\n";
+    return { next: content + sep + block + "\n", action: "created" };
+}
+/**
+ * Write the managed kit block into each detected agent's rules file.
+ * Read-only mode refuses + audits before any write.
+ */
+export async function writeAgentConfig(cwd = process.cwd(), targets) {
+    const { isReadOnlyMode, refuseWrite } = await import("./read-only-mode.js");
+    if (isReadOnlyMode()) {
+        const refusal = await refuseWrite("write-agent-config", {});
+        return [{ agent: "all", file: "-", action: "failed", detail: refusal.reason }];
+    }
+    const chosen = targets ?? detectAgentTargets(cwd);
+    const results = [];
+    for (const t of chosen) {
+        const path = resolve(cwd, t.file);
+        let existing = "";
+        try {
+            existing = await readFile(path, "utf-8");
+        }
+        catch {
+            existing = ""; // file absent — will be created
+        }
+        try {
+            const { next, action } = upsertKitBlock(existing);
+            if (action === "unchanged") {
+                results.push({ agent: t.agent, file: t.file, action, detail: "kit block already current" });
+                continue;
+            }
+            await writeFile(path, next, "utf-8");
+            results.push({
+                agent: t.agent,
+                file: t.file,
+                action,
+                detail: action === "created" ? `wrote kit block to ${t.file}` : `updated kit block in ${t.file}`,
+            });
+        }
+        catch (err) {
+            results.push({
+                agent: t.agent,
+                file: t.file,
+                action: "failed",
+                detail: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=agent-config.js.map

package/dist/agent-config.js.map

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

package/dist/agent-governance-model.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Agent Governance & Security Framework — data models
+ * Governance controls, permission systems, audit logging, and security policies
+ */
+export type PolicyType = "access_control" | "rate_limit" | "resource_quota" | "behavior_restriction";
+export type PolicyStatus = "draft" | "active" | "paused" | "deprecated";
+export type ActionType = "create" | "read" | "update" | "delete" | "execute" | "approve";
+export type PermissionLevel = "none" | "viewer" | "editor" | "admin" | "owner";
+export type AuditAction = "agent_created" | "agent_modified" | "permission_granted" | "permission_revoked" | "workflow_executed" | "policy_violated" | "secret_accessed" | "resource_used";
+export interface GovernancePolicy {
+    id: string;
+    team_id: string;
+    policy_name: string;
+    description: string;
+    policy_type: PolicyType;
+    status: PolicyStatus;
+    rules: {
+        condition: string;
+        action: string;
+        consequence?: string;
+    }[];
+    target_agents?: string[];
+    target_workflows?: string[];
+    priority: number;
+    enforcement_enabled: boolean;
+    created_by: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface AgentPermission {
+    id: string;
+    team_id: string;
+    agent_id: string;
+    resource_type: string;
+    resource_id?: string;
+    action: ActionType;
+    permission_level: PermissionLevel;
+    granted_by: string;
+    granted_at: string;
+    expires_at?: string;
+    conditions?: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+}
+export interface AgentSecurityProfile {
+    id: string;
+    team_id: string;
+    agent_id: string;
+    agent_type: string;
+    risk_level: "low" | "medium" | "high";
+    trust_score: number;
+    permissions: AgentPermission[];
+    violations_count: number;
+    last_violation?: string;
+    sandboxed: boolean;
+    resource_limits: {
+        max_concurrent_workflows: number;
+        max_api_calls_per_hour: number;
+        max_memory_mb: number;
+        max_storage_gb: number;
+    };
+    created_at: string;
+    updated_at: string;
+}
+export interface GovernanceAuditLog {
+    id: string;
+    team_id: string;
+    agent_id?: string;
+    action: AuditAction;
+    resource_type: string;
+    resource_id?: string;
+    details: Record<string, unknown>;
+    severity: "info" | "warning" | "critical";
+    status: "allowed" | "denied" | "warning";
+    policy_evaluated?: string;
+    timestamp: string;
+    created_at: string;
+}
+export interface RateLimitPolicy {
+    id: string;
+    team_id: string;
+    agent_id?: string;
+    resource_type: string;
+    requests_per_minute: number;
+    requests_per_hour: number;
+    requests_per_day: number;
+    burst_limit: number;
+    enabled: boolean;
+    created_at: string;
+    updated_at: string;
+}
+export interface ResourceQuota {
+    id: string;
+    team_id: string;
+    agent_id?: string;
+    resource_type: string;
+    limit: number;
+    unit: string;
+    period: "hour" | "day" | "month";
+    current_usage: number;
+    warning_threshold_percent: number;
+    created_at: string;
+    updated_at: string;
+}
+export interface GovernanceMetrics {
+    total_policies: number;
+    active_policies: number;
+    total_permissions: number;
+    agents_with_violations: number;
+    total_audit_events: number;
+    critical_events_count: number;
+    average_trust_score: number;
+    policy_violation_rate_percent: number;
+    average_response_time_ms: number;
+}
+export interface PolicyEvaluation {
+    id: string;
+    team_id: string;
+    policy_id: string;
+    agent_id: string;
+    action: ActionType;
+    resource_type: string;
+    allowed: boolean;
+    reason: string;
+    violated_rules?: string[];
+    timestamp: string;
+    created_at: string;
+}

package/dist/agent-governance-model.js

@@ -0,0 +1,6 @@
+/**
+ * Agent Governance & Security Framework — data models
+ * Governance controls, permission systems, audit logging, and security policies
+ */
+export {};
+//# sourceMappingURL=agent-governance-model.js.map

package/dist/agent-governance-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-governance-model.js","sourceRoot":"","sources":["../src/agent-governance-model.ts"],"names":[],"mappings":"AAAA;;;GAGG"}