@okfit/mcp 0.6.1 → 0.6.3

package/index.d.ts

@@ -3,8 +3,8 @@ import { FileSystem, Layer, Path, Schema, Stdio } from "effect";
 import { AppDirs, Xdg } from "@effected/xdg";
 import { LoadedConcept } from "@okfit/core";
 import { Distribution } from "@okfit/engine";
-import { ChildProcessSpawner } from "effect/unstable/process";
-import { Toolkit } from "effect/unstable/ai";
+import { ChildProcessSpawner } from "effect/process";
+import { Toolkit } from "effect/ai";
 //#region src/errors.d.ts
 declare const ConfigError_base: Schema.Class<ConfigError, Schema.TaggedStruct<"ConfigError", {
   readonly message: Schema.String;
@@ -87,7 +87,7 @@ export type McpToolError = typeof McpToolError.Type;
  * Amends N-19 and contract §6.1 (Ruling, task C4): a `McpServer.resource`
  * URI **template** routes a `McpSchema.param` through a single path
  * segment only — `FindMyWay`'s parametric matcher stops a param at the
- * next `/` (`.repos/effect/packages/effect/src/unstable/http/FindMyWay/internal/router.ts:355-360`),
+ * next `/` (`.repos/effect/packages/effect/src/http/FindMyWay/internal/router.ts:460-463`),
  * and every non-root OKF concept id nests under a type directory (D-12),
  * e.g. `metrics/revenue`. A templated `okf://concept/{id}` therefore never
  * routes a real bundle id. Static per-concept resources sidestep the
@@ -107,7 +107,7 @@ export type McpToolError = typeof McpToolError.Type;
  *
  * `content` builds the full `ReadResourceResult` itself, `mimeType`
  * included, rather than returning a bare string: verified against source
- * (`resolveResourceContent`, `unstable/ai/McpServer.ts:2324-2343`), a bare
+ * (`resolveResourceContent`, `ai/McpServer.ts:2556-2576`), a bare
  * string is wrapped as `{ contents: [{ uri, text }] }` with no `mimeType`
  * at all — the declared `mimeType` option only documents the resource in
  * `resources/list`, it is never merged into a `resources/read` response.
@@ -135,7 +135,7 @@ export declare const ConceptResources: (projectRoot: string) => Layer.Layer<neve
  *
  * `content` builds the full `ReadResourceResult` itself, `mimeType`
  * included, rather than returning a bare string: verified against source
- * (`resolveResourceContent`, `unstable/ai/McpServer.ts:2324-2343`), a bare
+ * (`resolveResourceContent`, `ai/McpServer.ts:2556-2576`), a bare
  * string is wrapped as `{ contents: [{ uri, text }] }` with no `mimeType`
  * at all — the declared `mimeType` option only documents the resource in
  * `resources/list`, it is never merged into a `resources/read` response.
@@ -409,7 +409,7 @@ export declare const ServerLayer: (projectRoot: string, options?: ServerOptions)
  * @public
  */
 export declare const OkfitToolkit: Toolkit.Toolkit<{
-  readonly concept_neighbors: import("effect/unstable/ai/Tool").Tool<"concept_neighbors", {
+  readonly concept_neighbors: import("effect/ai/Tool").Tool<"concept_neighbors", {
     readonly parameters: import("effect/Schema").Struct<{
       readonly id: import("effect/Schema").String;
     }>;
@@ -444,8 +444,8 @@ export declare const OkfitToolkit: Toolkit.Toolkit<{
     readonly failure: import("effect/Schema").Union<readonly [typeof ConfigError, typeof BundleNotFound, typeof ConceptNotFound, typeof UnknownVocabulary, typeof InvalidArgument]>;
     readonly failureMode: "error";
   }, import("@effected/xdg").AppDirs | import("effect/FileSystem").FileSystem | import("effect/Path").Path | import("@effected/xdg").Xdg>;
-  readonly describe_vocabulary: import("effect/unstable/ai/Tool").Tool<"describe_vocabulary", {
-    readonly parameters: import("effect/unstable/ai/Tool").EmptyParams;
+  readonly describe_vocabulary: import("effect/ai/Tool").Tool<"describe_vocabulary", {
+    readonly parameters: import("effect/ai/Tool").EmptyParams;
     readonly success: import("effect/Schema").Struct<{
       readonly project_root: import("effect/Schema").String;
       readonly bundle_root: import("effect/Schema").String;
@@ -477,7 +477,7 @@ export declare const OkfitToolkit: Toolkit.Toolkit<{
     readonly failure: import("effect/Schema").Union<readonly [typeof ConfigError, typeof BundleNotFound, typeof ConceptNotFound, typeof UnknownVocabulary, typeof InvalidArgument]>;
     readonly failureMode: "error";
   }, import("@effected/xdg").AppDirs | import("effect/FileSystem").FileSystem | import("effect/Path").Path | import("@effected/xdg").Xdg>;
-  readonly get_concept: import("effect/unstable/ai/Tool").Tool<"get_concept", {
+  readonly get_concept: import("effect/ai/Tool").Tool<"get_concept", {
     readonly parameters: import("effect/Schema").Struct<{
       readonly id: import("effect/Schema").String;
     }>;
@@ -501,7 +501,7 @@ export declare const OkfitToolkit: Toolkit.Toolkit<{
     readonly failure: import("effect/Schema").Union<readonly [typeof ConfigError, typeof BundleNotFound, typeof ConceptNotFound, typeof UnknownVocabulary, typeof InvalidArgument]>;
     readonly failureMode: "error";
   }, import("@effected/xdg").AppDirs | import("effect/FileSystem").FileSystem | import("effect/Path").Path | import("@effected/xdg").Xdg>;
-  readonly list_concepts: import("effect/unstable/ai/Tool").Tool<"list_concepts", {
+  readonly list_concepts: import("effect/ai/Tool").Tool<"list_concepts", {
     readonly parameters: import("effect/Schema").Struct<{
       readonly type: import("effect/Schema").optionalKey<import("effect/Schema").String>;
       readonly tags: import("effect/Schema").optionalKey<import("effect/Schema").$Array<import("effect/Schema").String>>;
@@ -524,7 +524,7 @@ export declare const OkfitToolkit: Toolkit.Toolkit<{
     readonly failure: import("effect/Schema").Union<readonly [typeof ConfigError, typeof BundleNotFound, typeof ConceptNotFound, typeof UnknownVocabulary, typeof InvalidArgument]>;
     readonly failureMode: "error";
   }, import("@effected/xdg").AppDirs | import("effect/FileSystem").FileSystem | import("effect/Path").Path | import("@effected/xdg").Xdg>;
-  readonly stale_report: import("effect/unstable/ai/Tool").Tool<"stale_report", {
+  readonly stale_report: import("effect/ai/Tool").Tool<"stale_report", {
     readonly parameters: import("effect/Schema").Struct<{
       readonly now: import("effect/Schema").optionalKey<import("effect/Schema").String>;
     }>;
@@ -547,7 +547,7 @@ export declare const OkfitToolkit: Toolkit.Toolkit<{
     readonly failure: import("effect/Schema").Union<readonly [typeof ConfigError, typeof BundleNotFound, typeof ConceptNotFound, typeof UnknownVocabulary, typeof InvalidArgument]>;
     readonly failureMode: "error";
   }, import("@effected/xdg").AppDirs | import("effect/FileSystem").FileSystem | import("effect/Path").Path | import("@effected/xdg").Xdg>;
-  readonly validate_bundle: import("effect/unstable/ai/Tool").Tool<"validate_bundle", {
+  readonly validate_bundle: import("effect/ai/Tool").Tool<"validate_bundle", {
     readonly parameters: import("effect/Schema").Struct<{
       readonly now: import("effect/Schema").optionalKey<import("effect/Schema").String>;
       readonly documents: import("effect/Schema").optionalKey<import("effect/Schema").$Array<import("effect/Schema").Struct<{
@@ -598,8 +598,8 @@ export declare const OkfitToolkit: Toolkit.Toolkit<{
  *
  * @public
  */
-export declare const ToolsLayer: (projectRoot: string, distribution?: Distribution) => import("effect/Layer").Layer<import("effect/unstable/ai/Tool").HandlersFor<{
-  readonly concept_neighbors: import("effect/unstable/ai/Tool").Tool<"concept_neighbors", {
+export declare const ToolsLayer: (projectRoot: string, distribution?: Distribution) => import("effect/Layer").Layer<import("effect/ai/Tool").HandlersFor<{
+  readonly concept_neighbors: import("effect/ai/Tool").Tool<"concept_neighbors", {
     readonly parameters: import("effect/Schema").Struct<{
       readonly id: import("effect/Schema").String;
     }>;
@@ -634,8 +634,8 @@ export declare const ToolsLayer: (projectRoot: string, distribution?: Distributi
     readonly failure: import("effect/Schema").Union<readonly [typeof ConfigError, typeof BundleNotFound, typeof ConceptNotFound, typeof UnknownVocabulary, typeof InvalidArgument]>;
     readonly failureMode: "error";
   }, import("@effected/xdg").AppDirs | import("effect/FileSystem").FileSystem | import("effect/Path").Path | import("@effected/xdg").Xdg>;
-  readonly describe_vocabulary: import("effect/unstable/ai/Tool").Tool<"describe_vocabulary", {
-    readonly parameters: import("effect/unstable/ai/Tool").EmptyParams;
+  readonly describe_vocabulary: import("effect/ai/Tool").Tool<"describe_vocabulary", {
+    readonly parameters: import("effect/ai/Tool").EmptyParams;
     readonly success: import("effect/Schema").Struct<{
       readonly project_root: import("effect/Schema").String;
       readonly bundle_root: import("effect/Schema").String;
@@ -667,7 +667,7 @@ export declare const ToolsLayer: (projectRoot: string, distribution?: Distributi
     readonly failure: import("effect/Schema").Union<readonly [typeof ConfigError, typeof BundleNotFound, typeof ConceptNotFound, typeof UnknownVocabulary, typeof InvalidArgument]>;
     readonly failureMode: "error";
   }, import("@effected/xdg").AppDirs | import("effect/FileSystem").FileSystem | import("effect/Path").Path | import("@effected/xdg").Xdg>;
-  readonly get_concept: import("effect/unstable/ai/Tool").Tool<"get_concept", {
+  readonly get_concept: import("effect/ai/Tool").Tool<"get_concept", {
     readonly parameters: import("effect/Schema").Struct<{
       readonly id: import("effect/Schema").String;
     }>;
@@ -691,7 +691,7 @@ export declare const ToolsLayer: (projectRoot: string, distribution?: Distributi
     readonly failure: import("effect/Schema").Union<readonly [typeof ConfigError, typeof BundleNotFound, typeof ConceptNotFound, typeof UnknownVocabulary, typeof InvalidArgument]>;
     readonly failureMode: "error";
   }, import("@effected/xdg").AppDirs | import("effect/FileSystem").FileSystem | import("effect/Path").Path | import("@effected/xdg").Xdg>;
-  readonly list_concepts: import("effect/unstable/ai/Tool").Tool<"list_concepts", {
+  readonly list_concepts: import("effect/ai/Tool").Tool<"list_concepts", {
     readonly parameters: import("effect/Schema").Struct<{
       readonly type: import("effect/Schema").optionalKey<import("effect/Schema").String>;
       readonly tags: import("effect/Schema").optionalKey<import("effect/Schema").$Array<import("effect/Schema").String>>;
@@ -714,7 +714,7 @@ export declare const ToolsLayer: (projectRoot: string, distribution?: Distributi
     readonly failure: import("effect/Schema").Union<readonly [typeof ConfigError, typeof BundleNotFound, typeof ConceptNotFound, typeof UnknownVocabulary, typeof InvalidArgument]>;
     readonly failureMode: "error";
   }, import("@effected/xdg").AppDirs | import("effect/FileSystem").FileSystem | import("effect/Path").Path | import("@effected/xdg").Xdg>;
-  readonly stale_report: import("effect/unstable/ai/Tool").Tool<"stale_report", {
+  readonly stale_report: import("effect/ai/Tool").Tool<"stale_report", {
     readonly parameters: import("effect/Schema").Struct<{
       readonly now: import("effect/Schema").optionalKey<import("effect/Schema").String>;
     }>;
@@ -737,7 +737,7 @@ export declare const ToolsLayer: (projectRoot: string, distribution?: Distributi
     readonly failure: import("effect/Schema").Union<readonly [typeof ConfigError, typeof BundleNotFound, typeof ConceptNotFound, typeof UnknownVocabulary, typeof InvalidArgument]>;
     readonly failureMode: "error";
   }, import("@effected/xdg").AppDirs | import("effect/FileSystem").FileSystem | import("effect/Path").Path | import("@effected/xdg").Xdg>;
-  readonly validate_bundle: import("effect/unstable/ai/Tool").Tool<"validate_bundle", {
+  readonly validate_bundle: import("effect/ai/Tool").Tool<"validate_bundle", {
     readonly parameters: import("effect/Schema").Struct<{
       readonly now: import("effect/Schema").optionalKey<import("effect/Schema").String>;
       readonly documents: import("effect/Schema").optionalKey<import("effect/Schema").$Array<import("effect/Schema").Struct<{

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@okfit/mcp",
-	"version": "0.6.1",
+	"version": "0.6.3",
 	"private": false,
 	"description": "Model Context Protocol server for okfit: query and understand Open Knowledge Format (OKF) bundles from an agent.",
 	"keywords": [
@@ -44,15 +44,23 @@
 		"okfit-mcp": "bin/okfit-mcp.js"
 	},
 	"dependencies": {
-		"@effect/platform-node": "4.0.0-rc.117",
-		"@effected/engine": "^0.1.0",
-		"@effected/git": "^0.17.0",
-		"@effected/mcp": "^0.2.0",
-		"@effected/xdg": "^0.7.0",
-		"@okfit/core": "0.8.0",
-		"@okfit/engine": "0.9.0",
-		"@okfit/profiles": "0.8.0",
-		"effect": "4.0.0-rc.117"
+		"@effect/platform-node": "4.0.0-rc.118",
+		"@effected/config-file": "^0.13.0",
+		"@effected/engine": "^0.2.0",
+		"@effected/git": "^0.18.1",
+		"@effected/glob": "^0.9.0",
+		"@effected/jsonc": "^0.14.0",
+		"@effected/markdown": "^0.14.0",
+		"@effected/mcp": "^0.3.0",
+		"@effected/schemastore": "^0.17.0",
+		"@effected/toml": "^0.10.0",
+		"@effected/walker": "^0.13.0",
+		"@effected/xdg": "^0.8.0",
+		"@effected/yaml": "^0.18.0",
+		"@okfit/core": "0.8.2",
+		"@okfit/engine": "0.9.2",
+		"@okfit/profiles": "0.8.1",
+		"effect": "4.0.0-rc.118"
 	},
 	"engines": {
 		"node": ">=24.11.0"

package/resources/conceptResource.js

@@ -1,7 +1,7 @@
 import { loadToolContext } from "../internal/toolContext.js";
 import { Effect, FileSystem, Layer, Path } from "effect";
 import { Derive } from "@okfit/core";
-import { McpSchema, McpServer } from "effect/unstable/ai";
+import { McpSchema, McpServer } from "effect/ai";
 
 //#region src/resources/conceptResource.ts
 /**
@@ -11,7 +11,7 @@ import { McpSchema, McpServer } from "effect/unstable/ai";
 * Amends N-19 and contract §6.1 (Ruling, task C4): a `McpServer.resource`
 * URI **template** routes a `McpSchema.param` through a single path
 * segment only — `FindMyWay`'s parametric matcher stops a param at the
-* next `/` (`.repos/effect/packages/effect/src/unstable/http/FindMyWay/internal/router.ts:355-360`),
+* next `/` (`.repos/effect/packages/effect/src/http/FindMyWay/internal/router.ts:460-463`),
 * and every non-root OKF concept id nests under a type directory (D-12),
 * e.g. `metrics/revenue`. A templated `okf://concept/{id}` therefore never
 * routes a real bundle id. Static per-concept resources sidestep the
@@ -31,7 +31,7 @@ import { McpSchema, McpServer } from "effect/unstable/ai";
 *
 * `content` builds the full `ReadResourceResult` itself, `mimeType`
 * included, rather than returning a bare string: verified against source
-* (`resolveResourceContent`, `unstable/ai/McpServer.ts:2324-2343`), a bare
+* (`resolveResourceContent`, `ai/McpServer.ts:2556-2576`), a bare
 * string is wrapped as `{ contents: [{ uri, text }] }` with no `mimeType`
 * at all — the declared `mimeType` option only documents the resource in
 * `resources/list`, it is never merged into a `resources/read` response.

package/resources/indexResource.js

@@ -1,6 +1,6 @@
 import { loadToolContext } from "../internal/toolContext.js";
 import { Effect, FileSystem, Path } from "effect";
-import { McpSchema, McpServer } from "effect/unstable/ai";
+import { McpSchema, McpServer } from "effect/ai";
 
 //#region src/resources/indexResource.ts
 /**
@@ -21,7 +21,7 @@ import { McpSchema, McpServer } from "effect/unstable/ai";
 *
 * `content` builds the full `ReadResourceResult` itself, `mimeType`
 * included, rather than returning a bare string: verified against source
-* (`resolveResourceContent`, `unstable/ai/McpServer.ts:2324-2343`), a bare
+* (`resolveResourceContent`, `ai/McpServer.ts:2556-2576`), a bare
 * string is wrapped as `{ contents: [{ uri, text }] }` with no `mimeType`
 * at all — the declared `mimeType` option only documents the resource in
 * `resources/list`, it is never merged into a `resources/read` response.

package/server.js

@@ -4,7 +4,7 @@ import { MCP_VERSION } from "./version.js";
 import { OkfitToolkit, ToolsLayer } from "./toolkit.js";
 import { McpStdio, McpToolkit } from "@effected/mcp";
 import { Layer } from "effect";
-import { McpProtocol } from "effect/unstable/ai";
+import { McpProtocol } from "effect/ai";
 import { Git } from "@effected/git";
 import { GitHistory } from "@okfit/profiles";
 

package/toolkit.js

@@ -4,7 +4,7 @@ import { getConcept, handleGetConcept } from "./tools/getConcept.js";
 import { handleListConcepts, listConcepts } from "./tools/listConcepts.js";
 import { handleStaleReport, staleReport } from "./tools/staleReport.js";
 import { handleValidateBundle, validateBundle } from "./tools/validateBundle.js";
-import { Toolkit } from "effect/unstable/ai";
+import { Toolkit } from "effect/ai";
 
 //#region src/toolkit.ts
 /**

package/tools/conceptNeighbors.js

@@ -5,7 +5,7 @@ import { ConceptNeighborsSuccess } from "../schema/tools.js";
 import { ToolFailure } from "@effected/mcp";
 import { Effect, FileSystem, Option, Path, Schema } from "effect";
 import { ConceptId, Graph } from "@okfit/core";
-import { Tool } from "effect/unstable/ai";
+import { Tool } from "effect/ai";
 import { AppDirs, Xdg } from "@effected/xdg";
 
 //#region src/tools/conceptNeighbors.ts

package/tools/describeVocabulary.js

@@ -2,7 +2,7 @@ import { McpToolError } from "../errors.js";
 import { resolveConfigOnly } from "../internal/toolContext.js";
 import { DescribeVocabularySuccess } from "../schema/tools.js";
 import { Effect, FileSystem, Option, Path } from "effect";
-import { Tool } from "effect/unstable/ai";
+import { Tool } from "effect/ai";
 import { contextEnvelope } from "@okfit/engine";
 import { AppDirs, Xdg } from "@effected/xdg";
 
@@ -13,7 +13,7 @@ const DESCRIPTION = "Returns this project's resolved okfit configuration: the pr
 * needs (`resolveConfigOnly` -> `resolveProjectConfig`/`provideConfig`);
 * without it `Tool.HandlerServices` infers `never` and the handler record
 * passed to `Toolkit.toLayer` fails to typecheck against `HandlersFrom`
-* (verified against `.repos/effect/packages/effect/src/unstable/ai/Tool.ts`
+* (verified against `.repos/effect/packages/effect/src/ai/Tool.ts`
 * `dependencies`/`HandlerServices`; not spelled out in the brief's snippet).
 *
 * `parameters` is `Tool.EmptyParams`, not the brief's `Schema.Struct({})`:
@@ -22,7 +22,7 @@ const DESCRIPTION = "Returns this project's resolved okfit configuration: the pr
 * its JSON Schema, reproduced in isolation against a minimal tool and
 * confirmed fixed by switching to `Tool.EmptyParams` — the same schema
 * Effect's own MCP conformance fixtures use for parameterless tools
-* (`.repos/effect/packages/effect/test/unstable/ai/McpServer/McpConformance/McpConformanceFixtures.ts:29`).
+* (`.repos/effect/packages/effect/test/ai/McpServer/McpConformance/McpConformanceFixtures.ts:38`).
 *
 * @public
 */

package/tools/getConcept.js

@@ -4,7 +4,7 @@ import { GetConceptSuccess } from "../schema/tools.js";
 import { ToolFailure } from "@effected/mcp";
 import { Effect, FileSystem, Option, Path, Schema } from "effect";
 import { ConceptId, Derive, Graph } from "@okfit/core";
-import { Tool } from "effect/unstable/ai";
+import { Tool } from "effect/ai";
 import { AppDirs, Xdg } from "@effected/xdg";
 
 //#region src/tools/getConcept.ts

package/tools/listConcepts.js

@@ -5,7 +5,7 @@ import { ListConceptsParams, ListConceptsSuccess } from "../schema/tools.js";
 import { ToolFailure } from "@effected/mcp";
 import { Effect, FileSystem, Path } from "effect";
 import { Derive } from "@okfit/core";
-import { Tool } from "effect/unstable/ai";
+import { Tool } from "effect/ai";
 import { AppDirs, Xdg } from "@effected/xdg";
 
 //#region src/tools/listConcepts.ts

package/tools/staleReport.js

@@ -5,7 +5,7 @@ import { StaleReportParams, StaleReportSuccess } from "../schema/tools.js";
 import { resolveNow } from "../internal/resolveNow.js";
 import { DateTime, Effect, FileSystem, Path } from "effect";
 import { Derive } from "@okfit/core";
-import { Tool } from "effect/unstable/ai";
+import { Tool } from "effect/ai";
 import { AppDirs, Xdg } from "@effected/xdg";
 
 //#region src/tools/staleReport.ts

package/tools/validateBundle.js

@@ -6,7 +6,7 @@ import { MCP_VERSION } from "../version.js";
 import { ToolFailure } from "@effected/mcp";
 import { Crypto, Effect, FileSystem, Option, Path } from "effect";
 import { OKF_SPEC_VERSION } from "@okfit/core";
-import { Tool } from "effect/unstable/ai";
+import { Tool } from "effect/ai";
 import { DocumentPathError, JsonEnvelope, collect, forDiagnostics, json, provideDocuments, run } from "@okfit/engine";
 import { Git } from "@effected/git";
 import { GitHistory } from "@okfit/profiles";

package/version.js

@@ -5,7 +5,7 @@
 *
 * @public
 */
-const MCP_VERSION = "0.6.1";
+const MCP_VERSION = "0.6.3";
 
 //#endregion
 export { MCP_VERSION };