@theihtisham/agent-shadow-brain 7.1.0 → 7.1.4

package/dist/brain/client-config.d.ts

@@ -0,0 +1,19 @@
+import { type WorkflowTarget } from './workflow-skills.js';
+export interface ClientConfigRecipe {
+    target: WorkflowTarget;
+    format: 'json' | 'toml' | 'yaml';
+    filename: string;
+    content: string;
+    notes: string[];
+}
+export interface MemoryLaunchOptions {
+    dbPath?: string;
+    projectId?: string;
+}
+export declare function memoryLaunchCommand(projectDir?: string, options?: MemoryLaunchOptions): {
+    command: string;
+    args: string[];
+};
+/** Render a recipe only. Never read or modify a client configuration file. */
+export declare function buildClientConfig(target: string, projectDir?: string, options?: MemoryLaunchOptions): ClientConfigRecipe;
+//# sourceMappingURL=client-config.d.ts.map

package/dist/brain/client-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-config.d.ts","sourceRoot":"","sources":["../../src/brain/client-config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE7E,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAC3E,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;CAClC;AACD,MAAM,WAAW,mBAAmB;IAAG,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE;AAC5E,wBAAgB,mBAAmB,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB;;;EASzF;AACD,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,kBAAkB,CAkB5H"}

package/dist/brain/client-config.js

@@ -0,0 +1,40 @@
+import { fileURLToPath } from 'node:url';
+import * as path from 'node:path';
+import { WORKFLOW_TARGETS } from './workflow-skills.js';
+export function memoryLaunchCommand(projectDir, options = {}) {
+    if (projectDir !== undefined && (typeof projectDir !== 'string' || !projectDir.trim() || /[\u0000-\u001f\u007f]/.test(projectDir))) {
+        throw new TypeError('Project directory must be nonempty text without control characters.');
+    }
+    if (options.dbPath !== undefined && (typeof options.dbPath !== 'string' || !options.dbPath.trim() || /[\u0000-\u001f\u007f]/.test(options.dbPath)))
+        throw new TypeError('Invalid memory-store path.');
+    if (options.projectId !== undefined && !/^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}$/.test(options.projectId))
+        throw new TypeError('Invalid project identifier.');
+    return { command: process.execPath, args: [fileURLToPath(new URL('../cli.js', import.meta.url)), 'mcp',
+            ...(projectDir ? [path.resolve(projectDir)] : []), '--stdio',
+            ...(options.dbPath ? ['--db', path.resolve(options.dbPath)] : []), ...(options.projectId ? ['--project-id', options.projectId] : [])] };
+}
+/** Render a recipe only. Never read or modify a client configuration file. */
+export function buildClientConfig(target, projectDir, options = {}) {
+    if (!Object.hasOwn(WORKFLOW_TARGETS, target))
+        throw new TypeError('Choose codex, claude-code, opencode, deepseek-harness, or portable.');
+    const launch = memoryLaunchCommand(projectDir, options);
+    const common = ['Merge this entry with existing settings; this command does not write configuration.',
+        'The executable paths belong to this installation. Regenerate the recipe after moving Node.js or the package.',
+        'Restart or reconnect the client, then confirm tools are listed. A recipe is not proof of a native client connection.',
+        ...(options.dbPath ? ['This recipe pins an explicit memory store; use the matching project workspace to inspect its knowledge and activity.'] : [])];
+    if (target === 'codex')
+        return { target, format: 'toml', filename: '.codex/config.toml',
+            content: '[mcp_servers.shadow_brain]\ncommand = ' + JSON.stringify(launch.command) + '\nargs = ' + JSON.stringify(launch.args) + '\n', notes: common };
+    if (target === 'opencode')
+        return { target, format: 'json', filename: 'opencode.json',
+            content: JSON.stringify({ $schema: 'https://opencode.ai/config.json', mcp: { servers: { shadow_brain: { type: 'local', command: [launch.command, ...launch.args] } } } }, null, 2),
+            notes: [...common, 'OpenCode V2 uses mcp.servers; older V1 installations use a different shape.'] };
+    if (target === 'deepseek-harness')
+        return { target, format: 'yaml', filename: 'Harness MCP client plugin entry',
+            content: '- id: shadow-brain\n  name: "@deepseek-ai/dsh-mcp-client"\n  config:\n    serverName: shadow_brain\n    transport: stdio\n    command: ' + JSON.stringify(launch.command) + '\n    args: ' + JSON.stringify(launch.args) + '\n',
+            notes: [...common, 'Enable the MCP client plugin in your selected Harness profile. Its documented bridge supports tools and resources; MCP prompt templates are unsupported.'] };
+    return { target: target, format: 'json', filename: target === 'claude-code' ? '.mcp.json' : 'MCP client settings',
+        content: JSON.stringify({ mcpServers: { shadow_brain: launch } }, null, 2), notes: [...common,
+            ...(target === 'portable' ? ['The mcpServers wrapper is common but not universal; consult your host configuration schema.'] : [])] };
+}
+//# sourceMappingURL=client-config.js.map

package/dist/brain/client-config.js.map

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

package/dist/brain/client-integrations.d.ts

@@ -0,0 +1,63 @@
+import type { GlobalBrain } from './global-brain.js';
+export declare const CLIENT_CAPABILITIES: readonly [{
+    readonly id: "codex";
+    readonly label: "Codex";
+    readonly target: "codex";
+    readonly docs: "https://developers.openai.com/codex/mcp/";
+}, {
+    readonly id: "claude-code";
+    readonly label: "Claude Code";
+    readonly target: "claude-code";
+    readonly docs: "https://code.claude.com/docs/en/mcp";
+}, {
+    readonly id: "opencode";
+    readonly label: "OpenCode";
+    readonly target: "opencode";
+    readonly docs: "https://opencode.ai/docs/mcp-servers/";
+}, {
+    readonly id: "deepseek-harness";
+    readonly label: "DeepSeek Harness";
+    readonly target: "deepseek-harness";
+    readonly docs: "https://github.com/deepseek-ai/deepseek-harness/blob/master/packages/mcp/mcp-client/README.md";
+}, {
+    readonly id: "portable";
+    readonly label: "Other compatible clients";
+    readonly target: "portable";
+    readonly docs: "https://modelcontextprotocol.io/specification/2025-06-18/basic/transports";
+}];
+export declare function inspectClientIntegrations(options?: {
+    projectDir?: string;
+    brain?: GlobalBrain;
+    localProjectId?: string;
+}): {
+    diagnostics: string;
+    checkedAt: string;
+    version: string;
+    checks: ({
+        id: string;
+        label: string;
+        status: string;
+        detail: string;
+        command?: undefined;
+    } | {
+        id: string;
+        label: string;
+        status: string;
+        detail: string;
+        command: string;
+    })[];
+    agents: {
+        note?: string | undefined;
+        id: "claude-code" | "opencode" | "deepseek-harness" | "codex" | "portable";
+        label: "Claude Code" | "OpenCode" | "Codex" | "DeepSeek Harness" | "Other compatible clients";
+        installation: string;
+        presentSkills: number;
+        totalSkills: number;
+        capabilities: string[];
+        detail: string;
+        command: string;
+        docs: "https://developers.openai.com/codex/mcp/" | "https://code.claude.com/docs/en/mcp" | "https://opencode.ai/docs/mcp-servers/" | "https://github.com/deepseek-ai/deepseek-harness/blob/master/packages/mcp/mcp-client/README.md" | "https://modelcontextprotocol.io/specification/2025-06-18/basic/transports";
+        config: import("./client-config.js").ClientConfigRecipe;
+    }[];
+};
+//# sourceMappingURL=client-integrations.d.ts.map

package/dist/brain/client-integrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-integrations.d.ts","sourceRoot":"","sources":["../../src/brain/client-integrations.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;EAMrB,CAAC;AAqBZ,wBAAgB,yBAAyB,CAAC,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsC5H"}

package/dist/brain/client-integrations.js

@@ -0,0 +1,79 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { WORKFLOW_TARGETS, listBundledSkills } from './workflow-skills.js';
+import { buildClientConfig } from './client-config.js';
+import { projectRoot } from './project-kit-paths.js';
+export const CLIENT_CAPABILITIES = Object.freeze([
+    { id: 'codex', label: 'Codex', target: 'codex', docs: 'https://developers.openai.com/codex/mcp/' },
+    { id: 'claude-code', label: 'Claude Code', target: 'claude-code', docs: 'https://code.claude.com/docs/en/mcp' },
+    { id: 'opencode', label: 'OpenCode', target: 'opencode', docs: 'https://opencode.ai/docs/mcp-servers/' },
+    { id: 'deepseek-harness', label: 'DeepSeek Harness', target: 'deepseek-harness', docs: 'https://github.com/deepseek-ai/deepseek-harness/blob/master/packages/mcp/mcp-client/README.md' },
+    { id: 'portable', label: 'Other compatible clients', target: 'portable', docs: 'https://modelcontextprotocol.io/specification/2025-06-18/basic/transports' },
+]);
+/** Inspect only explicitly selected project skill files, never client profiles or credentials. */
+function safeProject(projectDir) {
+    return projectRoot(projectDir);
+}
+function inspectSkill(root, relativePath) {
+    const parts = relativePath.split('/');
+    let current = root;
+    for (let i = 0; i < parts.length; i++) {
+        current = path.join(current, parts[i]);
+        let stat;
+        try {
+            stat = fs.lstatSync(current, { throwIfNoEntry: false });
+        }
+        catch {
+            return 'blocked';
+        }
+        if (!stat)
+            return 'missing';
+        if (stat.isSymbolicLink() || (i < parts.length - 1 ? !stat.isDirectory() : !stat.isFile()))
+            return 'blocked';
+    }
+    return 'present';
+}
+export function inspectClientIntegrations(options = {}) {
+    let root;
+    let projectError;
+    if (options.projectDir) {
+        try {
+            root = safeProject(options.projectDir);
+        }
+        catch {
+            projectError = 'Project directory is unavailable or blocked. Check its path, permissions, and linked ancestors.';
+        }
+    }
+    const skills = listBundledSkills().map(skill => skill.name);
+    const agents = CLIENT_CAPABILITIES.map(client => {
+        const skillRoot = WORKFLOW_TARGETS[client.target].skillRoot;
+        const checks = root ? skills.map(name => inspectSkill(root, skillRoot + '/' + name + '/SKILL.md')) : [];
+        const present = checks.filter(state => state === 'present').length;
+        const blocked = checks.includes('blocked');
+        const installation = projectError || blocked ? 'blocked' : !root ? 'not-checked' : present === skills.length ? 'complete' : present ? 'partial' : 'missing';
+        return {
+            id: client.id, label: client.label, installation, presentSkills: present, totalSkills: skills.length,
+            capabilities: ['Project workflow skills', 'MCP stdio when configured', 'Scoped context packs'],
+            detail: projectError || (blocked ? 'A skill path is linked or not a regular file. It was not read.' : root
+                ? present + ' of ' + skills.length + ' skill files found. Host loading and live connections are not checked.'
+                : 'Choose a project to check skill-file presence. No client profile is inspected.'),
+            command: 'shadow-brain skills install . --target ' + client.target + ' --apply', docs: client.docs,
+            config: buildClientConfig(client.id, root, options.localProjectId ? { dbPath: options.brain?.dbPath, projectId: options.localProjectId } : {}),
+            ...(client.id === 'deepseek-harness' ? { note: 'Enable the filesystem-skill and MCP client plugins in the host; no MCP server is enabled by default.' } : {}),
+        };
+    });
+    const [major, minor] = process.versions.node.split('.').map(Number);
+    const supported = (major === 22 && minor >= 13) || major === 24 || major >= 26;
+    const health = options.brain?.getStorageHealth();
+    const checks = [
+        { id: 'node', label: 'Node.js runtime', status: supported ? 'pass' : 'error', detail: process.versions.node },
+        { id: 'project', label: 'Selected project', status: projectError ? 'error' : root ? 'pass' : 'unknown', detail: projectError || (root ? 'Project skill paths checked without reading client profiles.' : 'No project selected.') },
+        { id: 'storage', label: 'Memory storage', status: health?.lastError ? 'error' : health?.initialized ? 'pass' : 'unknown',
+            detail: health?.lastError ? 'Storage reports ' + health.lastError.code + '.' : health?.initialized ? 'Store initialized; ' + health.pendingOperations + ' pending operations.' : 'Not initialized in this process. No read success is claimed.' },
+        { id: 'stdio', label: 'MCP transport', status: 'pass', detail: 'Standalone memory/workflow stdio service is included. This is capability information, not a connected-client claim.', command: 'shadow-brain mcp --stdio' },
+    ];
+    const result = { checkedAt: new Date().toISOString(), version: '7.1.4', checks, agents };
+    return { ...result, diagnostics: JSON.stringify({ version: result.version, checkedAt: result.checkedAt, node: process.versions.node,
+            checks, agents: agents.map(({ id, installation, presentSkills, totalSkills }) => ({ id, installation, presentSkills, totalSkills })) }, null, 2) };
+}
+//# sourceMappingURL=client-integrations.js.map

package/dist/brain/client-integrations.js.map

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

package/dist/brain/context-assembly.d.ts

@@ -0,0 +1,84 @@
+import { type GlobalBrain } from './global-brain.js';
+import { type FeatureFlags } from './feature-settings.js';
+import type { MemoryAnnotationSnapshot, MemoryRelationType } from './memory-annotations.js';
+import { type ContextRetrievalProfile, type ContextRetrievalReport } from './context-retrieval.js';
+import type { AgentTool } from '../types.js';
+import { type ProjectFeedbackSnapshot } from './project-feedback.js';
+export type { ContextRetrievalCandidate, ContextRetrievalProfile, ContextRetrievalReport } from './context-retrieval.js';
+export interface ContextAssemblyOptions {
+    projectId: string;
+    query?: string;
+    profile?: ContextRetrievalProfile;
+    expandRelated?: boolean;
+    maxEntries?: number;
+    tokenBudget?: number;
+    maxChars?: number;
+    includeCrossProject?: boolean;
+    features?: Pick<FeatureFlags, 'contextAssembly' | 'crossProjectContext'>;
+    minImportance?: number;
+    lookbackHours?: number;
+    alwaysInclude?: readonly string[];
+    annotations?: MemoryAnnotationSnapshot;
+    feedback?: ProjectFeedbackSnapshot;
+}
+export interface ContextMemoryRelation {
+    id: string;
+    type: MemoryRelationType;
+    memoryId: string;
+    otherMemoryId: string;
+    title?: string;
+    direction: 'incoming' | 'outgoing';
+}
+export interface ContextPackEntry {
+    id: string;
+    projectId: string;
+    projectName: string;
+    agentTool: AgentTool;
+    category: string;
+    excerpt: string;
+    excerptTruncated: boolean;
+    score: number;
+    createdAt: string | null;
+    matchedKeywords: string[];
+    sources: string[];
+    sourceReferences: Array<{
+        source: string;
+        memoryId: string;
+    }>;
+    duplicateIds: string[];
+    reasons: string[];
+    state: 'active';
+    related: ContextMemoryRelation[];
+}
+type InactiveReason = 'archived' | 'contested' | 'superseded';
+type ContextExclusion = {
+    id: string;
+    projectId?: string;
+    title?: string;
+    reason: 'duplicate' | 'budget' | 'limit' | 'empty' | 'lookback' | InactiveReason;
+};
+export interface ContextPack {
+    enabled: boolean;
+    projectId: string;
+    scope: 'project' | 'cross-project';
+    queryKeywords: string[];
+    entries: ContextPackEntry[];
+    excluded: ContextExclusion[];
+    budget: {
+        tokenBudget: number;
+        maxChars: number;
+        usedChars: number;
+        estimatedTokens: number;
+        estimator?: 'unicode-code-heuristic';
+        usedBytes?: number;
+    };
+    warnings: string[];
+    markdown: string;
+    retrieval?: ContextRetrievalReport;
+}
+type RecallSource = Pick<GlobalBrain, 'recallScored'> & Partial<Pick<GlobalBrain, 'getEntry' | 'contextEntries'>>;
+/** Share query cleanup with explained recall and limit the number of searched terms. */
+export declare function contextQueryKeywords(query: string | undefined): string[];
+/** Assemble bounded reference context from explained recall without reading files or writing memories. */
+export declare function assembleContext(brain: RecallSource, options: ContextAssemblyOptions): ContextPack;
+//# sourceMappingURL=context-assembly.d.ts.map

package/dist/brain/context-assembly.d.ts.map

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