@neurocode-ai/core 1.18.8

package/src/catalog.ts

@@ -0,0 +1,301 @@
+export * as Catalog from "./catalog"
+
+import { makeLocationNode } from "./effect/app-node"
+import { Array, Context, Effect, Layer, Option, Order, pipe, Schema } from "effect"
+import { Catalog } from "@neurocode-ai/schema/catalog"
+import { ModelV2 } from "./model"
+import { ProviderV2 } from "./provider"
+import { EventV2 } from "./event"
+import { Policy } from "./policy"
+import { State } from "./state"
+import { Integration } from "./integration"
+
+export type ProviderRecord = {
+  provider: ProviderV2.MutableInfo
+  models: Map<ModelV2.ID, ModelV2.MutableInfo>
+}
+
+export type DefaultModel = { providerID: ProviderV2.ID; modelID: ModelV2.ID }
+
+export const PolicyActions = Schema.Literals(["provider.use"])
+
+export const Event = Catalog.Event
+
+type Data = {
+  providers: Map<ProviderV2.ID, ProviderRecord>
+  defaultModel?: DefaultModel
+}
+
+export type Draft = {
+  provider: {
+    list: () => readonly ProviderRecord[]
+    get: (providerID: ProviderV2.ID) => ProviderRecord | undefined
+    update: (providerID: ProviderV2.ID, fn: (provider: ProviderV2.MutableInfo) => void) => void
+    remove: (providerID: ProviderV2.ID) => void
+  }
+  model: {
+    get: (providerID: ProviderV2.ID, modelID: ModelV2.ID) => ModelV2.Info | undefined
+    update: (providerID: ProviderV2.ID, modelID: ModelV2.ID, fn: (model: ModelV2.MutableInfo) => void) => void
+    remove: (providerID: ProviderV2.ID, modelID: ModelV2.ID) => void
+    default: {
+      get: () => DefaultModel | undefined
+      set: (providerID: ProviderV2.ID, modelID: ModelV2.ID) => void
+    }
+  }
+}
+
+export interface Interface extends State.Transformable<Draft> {
+  readonly provider: {
+    readonly get: (providerID: ProviderV2.ID) => Effect.Effect<ProviderV2.Info | undefined>
+    readonly all: () => Effect.Effect<ProviderV2.Info[]>
+    readonly available: () => Effect.Effect<ProviderV2.Info[]>
+  }
+  readonly model: {
+    readonly get: (providerID: ProviderV2.ID, modelID: ModelV2.ID) => Effect.Effect<ModelV2.Info | undefined>
+    readonly all: () => Effect.Effect<ModelV2.Info[]>
+    readonly available: () => Effect.Effect<ModelV2.Info[]>
+    readonly default: () => Effect.Effect<ModelV2.Info | undefined>
+    readonly small: (providerID: ProviderV2.ID) => Effect.Effect<ModelV2.Info | undefined>
+  }
+}
+
+export class Service extends Context.Service<Service, Interface>()("@neurocode/v2/Catalog") {}
+
+const layer = Layer.effect(
+  Service,
+  Effect.gen(function* () {
+    const events = yield* EventV2.Service
+    const policy = yield* Policy.Service
+    const integrations = yield* Integration.Service
+
+    const available = (provider: ProviderV2.Info, integration: Integration.Info | undefined) => {
+      if (provider.disabled) return false
+      if (typeof provider.request.body.apiKey === "string") return true
+      if (integration?.connections.length) return true
+      return provider.integrationID === undefined && !integration
+    }
+
+    const projectModel = (model: ModelV2.Info, provider: ProviderV2.Info) => {
+      const api =
+        model.api.type === "native" && !model.api.url && Object.keys(model.api.settings).length === 0
+          ? { ...provider.api, id: model.api.id }
+          : model.api.type === "aisdk" && provider.api.type === "aisdk" && !model.api.url
+            ? { ...model.api, url: provider.api.url, settings: { ...provider.api.settings, ...model.api.settings } }
+            : model.api.type === "aisdk" && provider.api.type === "aisdk"
+              ? { ...model.api, settings: { ...provider.api.settings, ...model.api.settings } }
+              : model.api
+      const request = {
+        headers: { ...provider.request.headers, ...model.request.headers },
+        body: { ...provider.request.body, ...model.request.body },
+        variant: model.request.variant,
+      }
+      return ModelV2.Info.make({
+        ...model,
+        api,
+        request,
+      })
+    }
+
+    const normalizeApi = (item: ProviderV2.MutableInfo | ModelV2.MutableInfo) => {
+      if (typeof item.request.body.baseURL !== "string") return
+      item.api.url = item.request.body.baseURL
+      delete item.request.body.baseURL
+    }
+
+    const state = State.create<Data, Draft>({
+      initial: () => ({ providers: new Map() }),
+      draft: (draft) => {
+        const result: Draft = {
+          provider: {
+            list: () => Array.fromIterable(draft.providers.values()) as ProviderRecord[],
+            get: (providerID) => draft.providers.get(providerID),
+            update: (providerID, fn) => {
+              let current = draft.providers.get(providerID)
+              if (!current) {
+                current = {
+                  provider: ProviderV2.Info.empty(providerID) as ProviderV2.MutableInfo,
+                  models: new Map<ModelV2.ID, ModelV2.MutableInfo>(),
+                }
+                draft.providers.set(providerID, current)
+              }
+              fn(current.provider)
+              normalizeApi(current.provider)
+            },
+            remove: (providerID) => {
+              draft.providers.delete(providerID)
+            },
+          },
+          model: {
+            get: (providerID, modelID) => draft.providers.get(providerID)?.models.get(modelID),
+            update: (providerID, modelID, fn) => {
+              let record = draft.providers.get(providerID)
+              if (!record) {
+                record = {
+                  provider: ProviderV2.Info.empty(providerID) as ProviderV2.MutableInfo,
+                  models: new Map<ModelV2.ID, ModelV2.MutableInfo>(),
+                }
+                draft.providers.set(providerID, record)
+              }
+              const model =
+                record.models.get(modelID) ?? (ModelV2.Info.empty(providerID, modelID) as ModelV2.MutableInfo)
+              if (!record.models.has(modelID)) record.models.set(modelID, model)
+              fn(model)
+              model.id = modelID
+              model.providerID = providerID
+              normalizeApi(model)
+            },
+            remove: (providerID, modelID) => {
+              draft.providers.get(providerID)?.models.delete(modelID)
+            },
+            default: {
+              get: () => draft.defaultModel,
+              set: (providerID, modelID) => {
+                draft.defaultModel = { providerID, modelID }
+              },
+            },
+          },
+        }
+        return result
+      },
+      finalize: Effect.fn("CatalogV2.finalize")(function* (catalog) {
+        if (policy.hasStatements()) {
+          for (const record of [...catalog.provider.list()]) {
+            if ((yield* policy.evaluate("provider.use", record.provider.id, "allow")) === "deny") {
+              catalog.provider.remove(record.provider.id)
+            }
+          }
+        }
+        yield* events.publish(Event.Updated, {})
+      }),
+    })
+    const result: Interface = {
+      transform: state.transform,
+      reload: state.reload,
+
+      provider: {
+        get: Effect.fn("CatalogV2.provider.get")(function* (providerID) {
+          return state.get().providers.get(providerID)?.provider
+        }),
+
+        all: Effect.fn("CatalogV2.provider.all")(function* () {
+          return Array.fromIterable(state.get().providers.values()).map((record) => record.provider)
+        }),
+
+        available: Effect.fn("CatalogV2.provider.available")(function* () {
+          const active = new Map((yield* integrations.list()).map((integration) => [integration.id, integration]))
+          return (yield* result.provider.all()).filter((provider) =>
+            available(provider, active.get(provider.integrationID ?? Integration.ID.make(provider.id))),
+          )
+        }),
+      },
+
+      model: {
+        get: Effect.fn("CatalogV2.model.get")(function* (providerID, modelID) {
+          const record = state.get().providers.get(providerID)
+          if (!record) return
+          const model = record.models.get(modelID)
+          return model && projectModel(model, record.provider)
+        }),
+
+        all: Effect.fn("CatalogV2.model.all")(function* () {
+          return pipe(
+            Array.fromIterable(state.get().providers.values()),
+            Array.flatMap((record) => {
+              return Array.fromIterable(record.models.values()).map((model) => projectModel(model, record.provider))
+            }),
+            Array.sortWith((item) => item.time.released, Order.flip(Order.Number)),
+          )
+        }),
+
+        available: Effect.fn("CatalogV2.model.available")(function* () {
+          const providers = new Set((yield* result.provider.available()).map((provider) => provider.id))
+          return (yield* result.model.all()).filter((model) => providers.has(model.providerID) && model.enabled)
+        }),
+
+        default: Effect.fn("CatalogV2.model.default")(function* () {
+          const defaultModel = state.get().defaultModel
+          if (defaultModel) {
+            const provider = yield* result.provider.get(defaultModel.providerID)
+            if (provider && (yield* result.provider.available()).some((item) => item.id === provider.id)) {
+              const model = yield* result.model.get(defaultModel.providerID, defaultModel.modelID)
+              if (model?.enabled) return model
+            }
+          }
+
+          return Option.getOrUndefined(
+            pipe(
+              yield* result.model.available(),
+              Array.sortWith((item) => item.time.released, Order.flip(Order.Number)),
+              Array.head,
+            ),
+          )
+        }),
+
+        small: Effect.fn("CatalogV2.model.small")(function* (providerID) {
+          const record = state.get().providers.get(providerID)
+          if (!record) return
+          const provider = record.provider
+
+          // TODO: Remove these provider-specific assumptions once model syncing reliably reports available deployments.
+          if (providerID === ProviderV2.ID.azure || providerID === ProviderV2.ID.make("azure-cognitive-services")) {
+            return
+          }
+
+          if (providerID === ProviderV2.ID.opencode) {
+            const gpt5Nano = record.models.get(ModelV2.ID.make("gpt-5-nano"))
+            if (gpt5Nano?.enabled && gpt5Nano.status === "active") return projectModel(gpt5Nano, provider)
+          }
+
+          const candidates = pipe(
+            Array.fromIterable(record.models.values()),
+            Array.filter(
+              (model) =>
+                model.providerID === providerID &&
+                model.enabled &&
+                model.status === "active" &&
+                model.capabilities.input.some((item) => item.startsWith("text")) &&
+                model.capabilities.output.some((item) => item.startsWith("text")),
+            ),
+            Array.map((model) => ({
+              model,
+              cost: model.cost[0] ? model.cost[0].input + model.cost[0].output : 999,
+              age: (Date.now() - model.time.released) / (1000 * 60 * 60 * 24 * 30),
+              small: SMALL_MODEL_RE.test(`${model.id} ${model.family ?? ""} ${model.name}`.toLowerCase()),
+            })),
+            Array.filter((item) => item.cost > 0 && item.age <= 18),
+          )
+
+          const pick = (items: typeof candidates) => {
+            const maxCost = Math.max(...items.map((item) => item.cost), 0.01)
+            const maxAge = Math.max(...items.map((item) => item.age), 0.01)
+            return pipe(
+              items,
+              Array.sortWith((item) => (item.cost / maxCost) * 0.8 + (item.age / maxAge) * 0.2, Order.Number),
+              Array.map((item) => projectModel(item.model, provider)),
+              Array.head,
+            )
+          }
+
+          return Option.getOrUndefined(
+            pipe(
+              candidates,
+              Array.filter((item) => item.small),
+              (items) => (items.length > 0 ? pick(items) : pick(candidates)),
+            ),
+          )
+        }),
+      },
+    }
+
+    return Service.of(result)
+  }),
+)
+
+const SMALL_MODEL_RE = /\b(nano|flash|lite|mini|haiku|small|fast)\b/
+
+export const locationLayer = layer.pipe(
+  Layer.provideMerge(Integration.locationLayer),
+  Layer.provideMerge(Policy.locationLayer),
+)
+
+export const node = makeLocationNode({ service: Service, layer, deps: [EventV2.node, Policy.node, Integration.node] })

package/src/command.ts

@@ -0,0 +1,64 @@
+export * as CommandV2 from "./command"
+
+import { makeLocationNode } from "./effect/app-node"
+import { Context, Effect, Layer, Types } from "effect"
+import { Command } from "@neurocode-ai/schema/command"
+import { State } from "./state"
+
+export const Info = Command.Info
+export type Info = Command.Info
+
+export type Data = {
+  commands: Map<string, Types.DeepMutable<Info>>
+}
+
+export type Draft = {
+  list: () => readonly Info[]
+  get: (name: string) => Info | undefined
+  update: (name: string, update: (command: Types.DeepMutable<Info>) => void) => void
+  remove: (name: string) => void
+}
+
+export interface Interface extends State.Transformable<Draft> {
+  readonly get: (name: string) => Effect.Effect<Info | undefined>
+  readonly list: () => Effect.Effect<Info[]>
+}
+
+export class Service extends Context.Service<Service, Interface>()("@neurocode/v2/Command") {}
+
+const layer = Layer.effect(
+  Service,
+  Effect.sync(() => {
+    const state = State.create<Data, Draft>({
+      initial: () => ({ commands: new Map() }),
+      draft: (draft) => ({
+        list: () => Array.from(draft.commands.values()) as Info[],
+        get: (name) => draft.commands.get(name),
+        update: (name, update) => {
+          const current = draft.commands.get(name) ?? ({ name, template: "" } as Types.DeepMutable<Info>)
+          if (!draft.commands.has(name)) draft.commands.set(name, current)
+          update(current)
+          current.name = name
+        },
+        remove: (name) => {
+          draft.commands.delete(name)
+        },
+      }),
+    })
+
+    return Service.of({
+      reload: state.reload,
+      transform: state.transform,
+      get: Effect.fn("CommandV2.get")(function* (name) {
+        return state.get().commands.get(name)
+      }),
+      list: Effect.fn("CommandV2.list")(function* () {
+        return Array.from(state.get().commands.values())
+      }),
+    })
+  }),
+)
+
+export const locationLayer = layer
+
+export const node = makeLocationNode({ service: Service, layer, deps: [] })

package/src/config/agent.ts

@@ -0,0 +1,25 @@
+export * as ConfigAgent from "./agent"
+
+import { Schema } from "effect"
+import { Permission } from "@neurocode-ai/schema/permission"
+import { ConfigProvider } from "./provider"
+import { PositiveInt } from "../schema"
+
+export const Color = Schema.Union([
+  Schema.String.check(Schema.isPattern(/^#[0-9a-fA-F]{6}$/)),
+  Schema.Literals(["primary", "secondary", "accent", "success", "warning", "error", "info"]),
+])
+
+export class Info extends Schema.Class<Info>("ConfigV2.Agent")({
+  model: Schema.String.pipe(Schema.optional),
+  variant: Schema.String.pipe(Schema.optional),
+  request: ConfigProvider.Request.pipe(Schema.optional),
+  system: Schema.String.pipe(Schema.optional),
+  description: Schema.String.pipe(Schema.optional),
+  mode: Schema.Literals(["subagent", "primary", "all"]).pipe(Schema.optional),
+  hidden: Schema.Boolean.pipe(Schema.optional),
+  color: Color.pipe(Schema.optional),
+  steps: PositiveInt.pipe(Schema.optional),
+  disabled: Schema.Boolean.pipe(Schema.optional),
+  permissions: Permission.Ruleset.pipe(Schema.optional),
+}) {}

package/src/config/attachments.ts

@@ -0,0 +1,15 @@
+export * as ConfigAttachments from "./attachments"
+
+import { Schema } from "effect"
+import { PositiveInt } from "../schema"
+
+export class Image extends Schema.Class<Image>("ConfigV2.Attachments.Image")({
+  auto_resize: Schema.Boolean.pipe(Schema.optional),
+  max_width: PositiveInt.pipe(Schema.optional),
+  max_height: PositiveInt.pipe(Schema.optional),
+  max_base64_bytes: PositiveInt.pipe(Schema.optional),
+}) {}
+
+export class Info extends Schema.Class<Info>("ConfigV2.Attachments")({
+  image: Image.pipe(Schema.optional),
+}) {}

package/src/config/command.ts

@@ -0,0 +1,12 @@
+export * as ConfigCommand from "./command"
+
+import { Schema } from "effect"
+
+export class Info extends Schema.Class<Info>("ConfigV2.Command")({
+  template: Schema.String,
+  description: Schema.String.pipe(Schema.optional),
+  agent: Schema.String.pipe(Schema.optional),
+  model: Schema.String.pipe(Schema.optional),
+  variant: Schema.String.pipe(Schema.optional),
+  subtask: Schema.Boolean.pipe(Schema.optional),
+}) {}

package/src/config/compaction.ts

@@ -0,0 +1,15 @@
+export * as ConfigCompaction from "./compaction"
+
+import { Schema } from "effect"
+import { NonNegativeInt } from "../schema"
+
+export class Keep extends Schema.Class<Keep>("ConfigV2.Compaction.Keep")({
+  tokens: NonNegativeInt.pipe(Schema.optional),
+}) {}
+
+export class Info extends Schema.Class<Info>("ConfigV2.Compaction")({
+  auto: Schema.Boolean.pipe(Schema.optional),
+  prune: Schema.Boolean.pipe(Schema.optional),
+  keep: Keep.pipe(Schema.optional),
+  buffer: NonNegativeInt.pipe(Schema.optional),
+}) {}

package/src/config/experimental.ts

@@ -0,0 +1,18 @@
+export * as ConfigExperimental from "./experimental"
+
+import { Schema } from "effect"
+import { Catalog } from "../catalog"
+import { Policy as PolicyV2 } from "../policy"
+
+// Each core domain exports the policy actions it supports. Adding an action to
+// this union makes it valid in authored config while keeping Policy generic.
+export const PolicyAction = Schema.Union([Catalog.PolicyActions])
+
+export class Policy extends Schema.Class<Policy>("ConfigV2.Experimental.Policy")({
+  ...PolicyV2.Info.fields,
+  action: PolicyAction,
+}) {}
+
+export class Experimental extends Schema.Class<Experimental>("ConfigV2.Experimental")({
+  policies: Policy.pipe(Schema.Array, Schema.optional),
+}) {}

package/src/config/formatter.ts

@@ -0,0 +1,12 @@
+export * as ConfigFormatter from "./formatter"
+
+import { Schema } from "effect"
+
+export class Entry extends Schema.Class<Entry>("ConfigV2.Formatter.Entry")({
+  disabled: Schema.Boolean.pipe(Schema.optional),
+  command: Schema.String.pipe(Schema.Array, Schema.optional),
+  environment: Schema.Record(Schema.String, Schema.String).pipe(Schema.optional),
+  extensions: Schema.String.pipe(Schema.Array, Schema.optional),
+}) {}
+
+export const Info = Schema.Union([Schema.Boolean, Schema.Record(Schema.String, Entry)])

package/src/config/lsp.ts

@@ -0,0 +1,18 @@
+export * as ConfigLSP from "./lsp"
+
+import { Schema } from "effect"
+
+export const Disabled = Schema.Struct({
+  disabled: Schema.Literal(true),
+})
+
+export class Server extends Schema.Class<Server>("ConfigV2.LSP.Server")({
+  command: Schema.String.pipe(Schema.Array),
+  extensions: Schema.String.pipe(Schema.Array, Schema.optional),
+  disabled: Schema.Boolean.pipe(Schema.optional),
+  env: Schema.Record(Schema.String, Schema.String).pipe(Schema.optional),
+  initialization: Schema.Record(Schema.String, Schema.Unknown).pipe(Schema.optional),
+}) {}
+
+export const Entry = Schema.Union([Disabled, Server])
+export const Info = Schema.Union([Schema.Boolean, Schema.Record(Schema.String, Entry)])

package/src/config/markdown.ts

@@ -0,0 +1,36 @@
+export * as ConfigMarkdown from "./markdown"
+
+import matter from "gray-matter"
+export function parse(content: string) {
+  try {
+    return matter(content)
+  } catch {
+    return matter(sanitize(content))
+  }
+}
+
+export function parseOption(content: string) {
+  try {
+    return parse(content)
+  } catch {
+    return undefined
+  }
+}
+
+// Other coding agents accept unquoted colons in frontmatter values. Retry
+// those values as YAML block scalars so existing config files keep working.
+export function sanitize(content: string) {
+  const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/)
+  if (!match) return content
+  const frontmatter = match[1]
+  const result = frontmatter.split(/\r?\n/).flatMap((line) => {
+    if (line.trim().startsWith("#") || line.trim() === "" || /^\s+/.test(line)) return [line]
+    const entry = line.match(/^([a-zA-Z_][a-zA-Z0-9_]*)\s*:\s*(.*)$/)
+    if (!entry) return [line]
+    const value = entry[2].trim()
+    if (value === "" || value === ">" || value === "|" || value.startsWith('"') || value.startsWith("'")) return [line]
+    if (!value.includes(":")) return [line]
+    return [`${entry[1]}: |-`, `  ${value}`]
+  })
+  return content.replace(frontmatter, () => result.join("\n"))
+}

package/src/config/mcp.ts

@@ -0,0 +1,48 @@
+export * as ConfigMCP from "./mcp"
+
+import { Schema } from "effect"
+import { PositiveInt } from "../schema"
+
+export class Timeout extends Schema.Class<Timeout>("ConfigV2.MCP.Timeout")({
+  startup: PositiveInt.pipe(Schema.optional).annotate({
+    description: "Maximum time in milliseconds to establish and initialize the MCP server.",
+  }),
+  request: PositiveInt.pipe(Schema.optional).annotate({
+    description: "Maximum time in milliseconds to wait for each MCP request after initialization.",
+  }),
+}) {}
+
+export class Local extends Schema.Class<Local>("ConfigV2.MCP.Local")({
+  type: Schema.Literal("local"),
+  command: Schema.String.pipe(Schema.Array),
+  cwd: Schema.String.pipe(Schema.optional).annotate({
+    description: "Working directory for the MCP server process. Relative paths resolve from the workspace directory.",
+  }),
+  environment: Schema.Record(Schema.String, Schema.String).pipe(Schema.optional),
+  disabled: Schema.Boolean.pipe(Schema.optional),
+  timeout: Timeout.pipe(Schema.optional),
+}) {}
+
+export class OAuth extends Schema.Class<OAuth>("ConfigV2.MCP.OAuth")({
+  client_id: Schema.String.pipe(Schema.optional),
+  client_secret: Schema.String.pipe(Schema.optional),
+  scope: Schema.String.pipe(Schema.optional),
+  callback_port: Schema.Int.check(Schema.isBetween({ minimum: 1, maximum: 65535 })).pipe(Schema.optional),
+  redirect_uri: Schema.String.pipe(Schema.optional),
+}) {}
+
+export class Remote extends Schema.Class<Remote>("ConfigV2.MCP.Remote")({
+  type: Schema.Literal("remote"),
+  url: Schema.String,
+  headers: Schema.Record(Schema.String, Schema.String).pipe(Schema.optional),
+  oauth: Schema.Union([OAuth, Schema.Literal(false)]).pipe(Schema.optional),
+  disabled: Schema.Boolean.pipe(Schema.optional),
+  timeout: Timeout.pipe(Schema.optional),
+}) {}
+
+export const Server = Schema.Union([Local, Remote]).pipe(Schema.toTaggedUnion("type"))
+
+export class Info extends Schema.Class<Info>("ConfigV2.MCP")({
+  timeout: Timeout.pipe(Schema.optional),
+  servers: Schema.Record(Schema.String, Server).pipe(Schema.optional),
+}) {}