@ytinnovation/harness-core 0.0.0

package/dist/mcp/tools/add-skill.js

@@ -0,0 +1,184 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { dirname, isAbsolute, join } from 'node:path';
+import { HarnessError } from '../../contracts/errors.js';
+import { prepareSkillInstallByName, prepareSkillInstallByUrl } from '../../skills/install.js';
+import { createStubInternalProvider } from '../../skills/providers/stub.js';
+import { createFileSkillRegistry } from '../../skills/registry.js';
+const DEFAULT_REGISTRY_RELATIVE_PATH = ['.harness', 'registry.json'];
+export const ADD_SKILL_TOOL = {
+    name: 'add_skill',
+    description: 'Install a missing skill by name or URL and return a create/update/skip summary.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            name: {
+                type: 'string',
+                description: 'Skill name from the internal catalog. Provide either name or url.',
+            },
+            url: {
+                type: 'string',
+                description: 'Skill package URL. Provide either url or name.',
+            },
+            targetDir: {
+                type: 'string',
+                description: 'Optional target directory for installed skill files (relative to workspace root by default).',
+            },
+            dryRun: {
+                type: 'boolean',
+                description: 'When true, only returns planned action and does not write files or registry.',
+            },
+        },
+        additionalProperties: false,
+    },
+};
+function isNodeError(error) {
+    return typeof error === 'object' && error !== null && 'code' in error;
+}
+function classifyInstallError(error) {
+    if (error instanceof HarnessError) {
+        if (error.code === 'SKILL_NOT_FOUND') {
+            return 'not-found';
+        }
+        if (error.code === 'SKILL_INSTALL_INVALID_NAME') {
+            return 'user-cancelled';
+        }
+    }
+    if (isNodeError(error)) {
+        if (error.code === 'EACCES' || error.code === 'EPERM') {
+            return 'permission-denied';
+        }
+        if (error.code === 'ECANCELED' || error.code === 'ABORT_ERR') {
+            return 'user-cancelled';
+        }
+        if (error.code === 'ECONNRESET'
+            || error.code === 'ENETUNREACH'
+            || error.code === 'ETIMEDOUT'
+            || error.code === 'EAI_AGAIN') {
+            return 'network-error';
+        }
+    }
+    return 'unavailable';
+}
+function resolveInstallTargetDir(workspaceRoot, input) {
+    if (!input.targetDir || input.targetDir.trim().length === 0) {
+        return join(workspaceRoot, '.agents', 'skills');
+    }
+    if (isAbsolute(input.targetDir)) {
+        return input.targetDir;
+    }
+    return join(workspaceRoot, input.targetDir);
+}
+function toInstallTargetPath(targetDir, skillName) {
+    return join(targetDir, skillName.trim(), 'SKILL.md');
+}
+async function planSkillInstall(skillName, targetPath, nextContent) {
+    try {
+        const existingContent = await readFile(targetPath, 'utf8');
+        if (existingContent === nextContent) {
+            return {
+                action: 'skip',
+                skillName,
+                targetPath,
+                reason: 'Existing file content is identical to the incoming skill package.',
+            };
+        }
+        return {
+            action: 'update',
+            skillName,
+            targetPath,
+            reason: 'Target skill file already exists with different local content; review before update.',
+        };
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return {
+                action: 'create',
+                skillName,
+                targetPath,
+                reason: 'Target skill file does not exist yet.',
+            };
+        }
+        throw error;
+    }
+}
+function createDefaultDependencies() {
+    return {
+        internalProvider: createStubInternalProvider(),
+        resolveByUrl: async () => {
+            throw new HarnessError('SKILL_NOT_FOUND', 'URL-based install requires a configured URL resolver for MCP add_skill.');
+        },
+    };
+}
+export function createAddSkillTool(dependencies = {}) {
+    const merged = {
+        ...createDefaultDependencies(),
+        ...dependencies,
+    };
+    return async function addSkillTool(input, context) {
+        const name = typeof input?.name === 'string' ? input.name.trim() : '';
+        const url = typeof input?.url === 'string' ? input.url.trim() : '';
+        const hasName = name.length > 0;
+        const hasUrl = url.length > 0;
+        if (hasName === hasUrl) {
+            return {
+                status: 'error',
+                message: 'Provide exactly one of `name` or `url` when calling add_skill.',
+                data: null,
+                errorCode: 'user-cancelled',
+            };
+        }
+        const dryRun = input?.dryRun === true;
+        const source = hasUrl ? 'url' : 'name';
+        try {
+            const prepared = hasUrl
+                ? await prepareSkillInstallByUrl(url, {
+                    resolveByUrl: merged.resolveByUrl,
+                    now: merged.now,
+                })
+                : await prepareSkillInstallByName(name, {
+                    provider: merged.internalProvider,
+                    now: merged.now,
+                });
+            const targetDir = resolveInstallTargetDir(context.workspaceRoot, input ?? {});
+            const targetPath = toInstallTargetPath(targetDir, prepared.installedRecord.skillName);
+            const plan = await planSkillInstall(prepared.installedRecord.skillName, targetPath, prepared.packageContent);
+            if (!dryRun && plan.action === 'create') {
+                await mkdir(dirname(plan.targetPath), { recursive: true });
+                await writeFile(plan.targetPath, prepared.packageContent, 'utf8');
+            }
+            if (!dryRun) {
+                const registryPath = join(context.workspaceRoot, ...DEFAULT_REGISTRY_RELATIVE_PATH);
+                const registry = createFileSkillRegistry(registryPath);
+                const installedRecord = {
+                    ...prepared.installedRecord,
+                    installPath: plan.targetPath,
+                };
+                if (plan.action !== 'skip') {
+                    await registry.add(installedRecord);
+                }
+            }
+            return {
+                status: 'success',
+                message: `Skill ${prepared.installedRecord.skillName} ${dryRun ? 'planned' : 'processed'} with action ${plan.action}.`,
+                data: {
+                    action: plan.action,
+                    skillName: prepared.installedRecord.skillName,
+                    source,
+                    installPath: plan.targetPath,
+                    reason: plan.reason,
+                    dryRun,
+                },
+            };
+        }
+        catch (error) {
+            return {
+                status: 'error',
+                message: error instanceof Error ? error.message : String(error),
+                data: null,
+                errorCode: classifyInstallError(error),
+            };
+        }
+    };
+}
+export const addSkillTool = createAddSkillTool();
+//# sourceMappingURL=add-skill.js.map

package/dist/mcp/tools/add-skill.js.map

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

package/dist/mcp/tools/assemble-init-assets.d.ts

@@ -0,0 +1,26 @@
+import type { InitAnswers, ProjectFingerprint } from '../../init/types.js';
+import { type CloudAssetClient, type CloudAssetDescriptor } from '../../init/cloud-asset-client.js';
+import type { McpToolDefinition, McpToolResult } from '../types.js';
+export interface AssembleInitAssetsInput {
+    fingerprint?: Omit<ProjectFingerprint, 'cwd'> & {
+        cwd?: string;
+    };
+    answers?: InitAnswers;
+}
+export interface AssembleInitAssetsData {
+    assembled: boolean;
+    explainableLog: string[];
+    fallbackReason?: string;
+    assets: CloudAssetDescriptor[];
+}
+export interface AssembleInitAssetsToolDependencies {
+    cloudAssetClient: CloudAssetClient;
+}
+export declare const ASSEMBLE_INIT_ASSETS_TOOL: McpToolDefinition;
+export declare function createAssembleInitAssetsTool(dependencies?: Partial<AssembleInitAssetsToolDependencies>): (input: AssembleInitAssetsInput | undefined, context: {
+    workspaceRoot: string;
+}) => Promise<McpToolResult<AssembleInitAssetsData>>;
+export declare const assembleInitAssetsTool: (input: AssembleInitAssetsInput | undefined, context: {
+    workspaceRoot: string;
+}) => Promise<McpToolResult<AssembleInitAssetsData>>;
+//# sourceMappingURL=assemble-init-assets.d.ts.map

package/dist/mcp/tools/assemble-init-assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assemble-init-assets.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/assemble-init-assets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EAC1B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEpE,MAAM,WAAW,uBAAuB;IACtC,WAAW,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,KAAK,CAAC,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,oBAAoB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,kCAAkC;IACjD,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAED,eAAO,MAAM,yBAAyB,EAAE,iBAmBvC,CAAC;AAuEF,wBAAgB,4BAA4B,CAC1C,YAAY,GAAE,OAAO,CAAC,kCAAkC,CAAM,WAKrD,uBAAuB,GAAG,SAAS,WACjC;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,KACjC,OAAO,CAAC,aAAa,CAAC,sBAAsB,CAAC,CAAC,CAuDlD;AAED,eAAO,MAAM,sBAAsB,UA3DxB,uBAAuB,GAAG,SAAS,WACjC;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,KACjC,OAAO,CAAC,aAAa,CAAC,sBAAsB,CAAC,CAyDkB,CAAC"}

package/dist/mcp/tools/assemble-init-assets.js

@@ -0,0 +1,136 @@
+import { createCloudAssetClientUnavailableError, createDefaultCloudAssetClient, } from '../../init/cloud-asset-client.js';
+export const ASSEMBLE_INIT_ASSETS_TOOL = {
+    name: 'assemble_init_assets',
+    description: 'Assemble init assets from cloud dynamic policy and return explainable log, reasons, and source metadata.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            fingerprint: {
+                type: 'object',
+                description: 'Project fingerprint detected by harness init.',
+            },
+            answers: {
+                type: 'object',
+                description: 'Init answers used for selecting requested asset types.',
+            },
+        },
+        required: ['fingerprint', 'answers'],
+        additionalProperties: false,
+    },
+};
+function createDefaultAnswers() {
+    return {
+        mode: 'cloud-auto',
+        useSkills: false,
+        includeRules: false,
+        bootstrapMcp: false,
+        syncSpec: false,
+        generateReadme: false,
+        enableRedaction: false,
+    };
+}
+function createDefaultFingerprint(workspaceRoot) {
+    return {
+        cwd: workspaceRoot,
+        languages: ['unknown'],
+        packageManager: 'unknown',
+        markers: {
+            packageJson: false,
+            tsconfigJson: false,
+            pyprojectToml: false,
+            requirementsTxt: false,
+            pomXml: false,
+            buildGradle: false,
+            composerJson: false,
+            git: false,
+        },
+        gitIdentity: {
+            name: null,
+            email: null,
+        },
+        recommendations: [],
+    };
+}
+function resolveInput(input, workspaceRoot) {
+    const defaults = createDefaultFingerprint(workspaceRoot);
+    const fingerprint = input?.fingerprint;
+    const answers = input?.answers;
+    if (!fingerprint || !answers) {
+        throw new Error('assemble_init_assets requires both fingerprint and answers.');
+    }
+    return {
+        fingerprint: {
+            ...defaults,
+            ...fingerprint,
+            cwd: fingerprint.cwd ?? workspaceRoot,
+            markers: {
+                ...defaults.markers,
+                ...fingerprint.markers,
+            },
+            gitIdentity: {
+                ...defaults.gitIdentity,
+                ...fingerprint.gitIdentity,
+            },
+            recommendations: fingerprint.recommendations ?? [],
+        },
+        answers: {
+            ...createDefaultAnswers(),
+            ...answers,
+        },
+    };
+}
+export function createAssembleInitAssetsTool(dependencies = {}) {
+    const cloudAssetClient = dependencies.cloudAssetClient ?? createDefaultCloudAssetClient();
+    return async (input, context) => {
+        let resolved;
+        try {
+            resolved = resolveInput(input, context.workspaceRoot);
+        }
+        catch (error) {
+            return {
+                status: 'error',
+                message: error instanceof Error ? error.message : String(error),
+                data: null,
+                errorCode: 'user-cancelled',
+            };
+        }
+        try {
+            const assembledResult = await cloudAssetClient.assembleAssets({
+                fingerprint: resolved.fingerprint,
+                answers: resolved.answers,
+            });
+            return {
+                status: 'success',
+                message: 'Dynamic assembly completed for init assets.',
+                data: {
+                    assembled: assembledResult.assembled,
+                    explainableLog: assembledResult.explainableLog,
+                    fallbackReason: assembledResult.fallbackReason,
+                    assets: assembledResult.assets,
+                },
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            const unavailableByMessage = /HARNESS_CLOUD_BASE_URL is not configured|Cloud asset service is unavailable/i.test(message);
+            const unavailableByCode = error instanceof Error && 'code' in error && error.code === 'INIT_CLOUD_UNAVAILABLE';
+            if (unavailableByMessage || unavailableByCode) {
+                return {
+                    status: 'unavailable',
+                    message: 'Dynamic assembly service is unavailable. Configure HARNESS_CLOUD_BASE_URL or provide a cloud asset client.',
+                    data: null,
+                    errorCode: 'unavailable',
+                };
+            }
+            const fallback = createCloudAssetClientUnavailableError(message);
+            return {
+                status: 'error',
+                message: fallback.message,
+                data: null,
+                errorCode: 'network-error',
+            };
+        }
+    };
+}
+export const assembleInitAssetsTool = createAssembleInitAssetsTool();
+//# sourceMappingURL=assemble-init-assets.js.map

package/dist/mcp/tools/assemble-init-assets.js.map

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

package/dist/mcp/tools/query-knowledge.d.ts

@@ -0,0 +1,28 @@
+import type { HarnessConfig } from '../../contracts/config.js';
+import type { GatewayRequestContext } from '../../gateway/auth.js';
+import type { GatewayClient } from '../../gateway/client.js';
+import type { KnowledgeQueryResponse } from '../../knowledge/types.js';
+import type { McpToolDefinition, McpToolResult } from '../types.js';
+export interface QueryKnowledgeToolContext {
+    workspaceRoot: string;
+    harnessConfig?: Pick<HarnessConfig, 'knowledgeMountPath'>;
+    gateway?: {
+        client: GatewayClient;
+        requestContext: Omit<GatewayRequestContext, 'workspaceRoot' | 'toolName'>;
+        targetModel?: string;
+    };
+}
+export interface QueryKnowledgeInput {
+    query?: string;
+    sourcePath?: string;
+    maxResults?: number;
+}
+export interface QueryKnowledgeData {
+    query: string;
+    configuredSourcePath: string;
+    resolvedSourcePath: string;
+    response: KnowledgeQueryResponse;
+}
+export declare const QUERY_KNOWLEDGE_TOOL: McpToolDefinition;
+export declare function queryKnowledgeTool(input: QueryKnowledgeInput | undefined, context: QueryKnowledgeToolContext): Promise<McpToolResult<QueryKnowledgeData>>;
+//# sourceMappingURL=query-knowledge.d.ts.map

package/dist/mcp/tools/query-knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-knowledge.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/query-knowledge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,KAAK,EAAE,iBAAiB,EAAoB,aAAa,EAAE,MAAM,aAAa,CAAC;AAEtF,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,oBAAoB,CAAC,CAAC;IAC1D,OAAO,CAAC,EAAE;QACR,MAAM,EAAE,aAAa,CAAC;QACtB,cAAc,EAAE,IAAI,CAAC,qBAAqB,EAAE,eAAe,GAAG,UAAU,CAAC,CAAC;QAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,sBAAsB,CAAC;CAClC;AAED,eAAO,MAAM,oBAAoB,EAAE,iBAuBlC,CAAC;AAcF,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,mBAAmB,GAAG,SAAS,EACtC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,aAAa,CAAC,kBAAkB,CAAC,CAAC,CAkE5C"}

package/dist/mcp/tools/query-knowledge.js

@@ -0,0 +1,92 @@
+import { queryKnowledgeSource } from '../../knowledge/query.js';
+export const QUERY_KNOWLEDGE_TOOL = {
+    name: 'query_knowledge',
+    description: 'Query configured knowledge sources through a shared response shape with success and unavailable states.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'Search query for the configured knowledge source.',
+            },
+            sourcePath: {
+                type: 'string',
+                description: 'Optional relative source override. Defaults to harnessConfig.knowledgeMountPath.',
+            },
+            maxResults: {
+                type: 'number',
+                minimum: 1,
+                description: 'Optional cap for returned hits.',
+            },
+        },
+        additionalProperties: false,
+    },
+};
+function mapQueryKnowledgeErrorCode(status, upstreamCode) {
+    if (status === 'error' && upstreamCode === 'KNOWLEDGE_QUERY_INVALID') {
+        return 'user-cancelled';
+    }
+    if (status === 'unavailable' && upstreamCode === 'KNOWLEDGE_SOURCE_UNAVAILABLE') {
+        return 'unavailable';
+    }
+    return 'unavailable';
+}
+export async function queryKnowledgeTool(input, context) {
+    if (context.gateway) {
+        const gatewayResult = await context.gateway.client.prepareRequest({
+            ...context.gateway.requestContext,
+            workspaceRoot: context.workspaceRoot,
+            toolName: 'query_knowledge',
+        }, {
+            targetModel: context.gateway.targetModel ?? 'harness-knowledge-gateway',
+            operation: 'query_knowledge',
+        });
+        if (gatewayResult.status === 'error') {
+            const errorCode = gatewayResult.error.failureType === 'authorization' ? 'permission-denied' : 'unavailable';
+            return {
+                status: 'error',
+                message: `${gatewayResult.error.message} ${gatewayResult.error.guidance}`.trim(),
+                data: null,
+                errorCode,
+            };
+        }
+    }
+    const options = {
+        workspaceRoot: context.workspaceRoot,
+        query: input?.query ?? '',
+        sourcePath: typeof input?.sourcePath === 'string' && input.sourcePath.trim().length > 0
+            ? input.sourcePath.trim()
+            : context.harnessConfig?.knowledgeMountPath?.trim(),
+        maxResults: input?.maxResults,
+    };
+    const result = await queryKnowledgeSource(options);
+    if (result.status === 'unavailable') {
+        return {
+            status: 'unavailable',
+            message: result.message.includes('No knowledge source configured')
+                ? 'No knowledge source configured. Set harnessConfig.knowledgeMountPath before calling query_knowledge.'
+                : result.message,
+            data: null,
+            errorCode: mapQueryKnowledgeErrorCode(result.status, result.errorCode),
+        };
+    }
+    if (result.status === 'error') {
+        return {
+            status: 'error',
+            message: 'Query is required. Provide a non-empty query when calling query_knowledge.',
+            data: null,
+            errorCode: mapQueryKnowledgeErrorCode(result.status, result.errorCode),
+        };
+    }
+    return {
+        status: 'success',
+        message: `Knowledge query executed against ${result.configuredSourcePath}.`,
+        data: {
+            query: result.response.query,
+            configuredSourcePath: result.configuredSourcePath,
+            resolvedSourcePath: result.resolvedSourcePath,
+            response: result.response,
+        },
+    };
+}
+//# sourceMappingURL=query-knowledge.js.map

package/dist/mcp/tools/query-knowledge.js.map

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

package/dist/mcp/tools/read-instructions.d.ts

@@ -0,0 +1,14 @@
+import type { McpToolDefinition, McpToolResult } from '../types.js';
+export interface ReadInstructionsToolContext {
+    workspaceRoot: string;
+}
+export interface ReadInstructionsInput {
+    path?: string;
+}
+export interface ReadInstructionsData {
+    path: string;
+    content: string;
+}
+export declare const READ_INSTRUCTIONS_TOOL: McpToolDefinition;
+export declare function readInstructionsTool(input: ReadInstructionsInput | undefined, context: ReadInstructionsToolContext): Promise<McpToolResult<ReadInstructionsData>>;
+//# sourceMappingURL=read-instructions.d.ts.map

package/dist/mcp/tools/read-instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-instructions.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/read-instructions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAoB,aAAa,EAAE,MAAM,aAAa,CAAC;AAEtF,MAAM,WAAW,2BAA2B;IAC1C,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,eAAO,MAAM,sBAAsB,EAAE,iBAapC,CAAC;AA6CF,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,qBAAqB,GAAG,SAAS,EACxC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC,CAkC9C"}

package/dist/mcp/tools/read-instructions.js

@@ -0,0 +1,81 @@
+import { readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+const DEFAULT_INSTRUCTION_PATHS = ['CODEX.md', 'AGENTS.md', 'AI_CODING_README.md', '.harness/rules.md'];
+export const READ_INSTRUCTIONS_TOOL = {
+    name: 'read_instructions',
+    description: 'Read project instructions from standard guidance files.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            path: {
+                type: 'string',
+                description: 'Optional relative path to an instructions file inside the workspace root.',
+            },
+        },
+        additionalProperties: false,
+    },
+};
+function resolveCandidatePaths(input, workspaceRoot) {
+    const sourcePath = typeof input?.path === 'string' && input.path.trim().length > 0
+        ? input.path.trim()
+        : null;
+    const relativePaths = sourcePath === null ? [...DEFAULT_INSTRUCTION_PATHS] : [sourcePath];
+    return relativePaths.map((relativePath) => ({
+        relativePath,
+        absolutePath: resolve(workspaceRoot, relativePath),
+    }));
+}
+function isNodeError(error) {
+    return typeof error === 'object' && error !== null && 'code' in error;
+}
+function classifyReadError(error) {
+    if (isNodeError(error)) {
+        if (error.code === 'EACCES' || error.code === 'EPERM') {
+            return 'permission-denied';
+        }
+        if (error.code === 'ECANCELED' || error.code === 'ABORT_ERR') {
+            return 'user-cancelled';
+        }
+        if (error.code === 'ECONNRESET'
+            || error.code === 'ENETUNREACH'
+            || error.code === 'ETIMEDOUT'
+            || error.code === 'EAI_AGAIN') {
+            return 'network-error';
+        }
+    }
+    return 'unavailable';
+}
+export async function readInstructionsTool(input, context) {
+    const candidates = resolveCandidatePaths(input, context.workspaceRoot);
+    for (const candidate of candidates) {
+        try {
+            const content = await readFile(candidate.absolutePath, 'utf8');
+            return {
+                status: 'success',
+                message: `Loaded instructions from ${candidate.relativePath}.`,
+                data: {
+                    path: candidate.relativePath,
+                    content,
+                },
+            };
+        }
+        catch (error) {
+            if (isNodeError(error) && error.code === 'ENOENT') {
+                continue;
+            }
+            return {
+                status: 'error',
+                message: `Failed to read instruction source at ${candidate.relativePath}.`,
+                data: null,
+                errorCode: classifyReadError(error),
+            };
+        }
+    }
+    return {
+        status: 'unavailable',
+        message: `No instruction source found. Checked: ${candidates.map((candidate) => candidate.relativePath).join(', ')}`,
+        data: null,
+        errorCode: 'not-found',
+    };
+}
+//# sourceMappingURL=read-instructions.js.map

package/dist/mcp/tools/read-instructions.js.map

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

package/dist/mcp/tools/sync-spec.d.ts

@@ -0,0 +1,17 @@
+import type { HarnessConfig } from '../../contracts/config.js';
+import type { McpToolDefinition, McpToolResult } from '../types.js';
+export interface SyncSpecToolContext {
+    workspaceRoot: string;
+    harnessConfig?: Pick<HarnessConfig, 'specMountPath'>;
+}
+export interface SyncSpecInput {
+    mountPath?: string;
+}
+export interface SyncSpecData {
+    configuredMountPath: string;
+    resolvedPath: string;
+    sourceType: 'file' | 'directory';
+}
+export declare const SYNC_SPEC_TOOL: McpToolDefinition;
+export declare function syncSpecTool(input: SyncSpecInput | undefined, context: SyncSpecToolContext): Promise<McpToolResult<SyncSpecData>>;
+//# sourceMappingURL=sync-spec.d.ts.map

package/dist/mcp/tools/sync-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-spec.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/sync-spec.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAoB,aAAa,EAAE,MAAM,aAAa,CAAC;AAEtF,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,GAAG,WAAW,CAAC;CAClC;AAED,eAAO,MAAM,cAAc,EAAE,iBAc5B,CAAC;AA6BF,wBAAsB,YAAY,CAChC,KAAK,EAAE,aAAa,GAAG,SAAS,EAChC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CA+CtC"}