@codeworksh/plugin 0.0.1-dev.20260922103030

package/package.json

@@ -0,0 +1,200 @@
+{
+	"name": "@codeworksh/plugin",
+	"version": "0.0.1-dev.20260922103030",
+	"description": "SDK for building CodeWork plugins — the plugin, tool, and sandbox contracts shared with @codeworksh/harness.",
+	"keywords": [
+		"agent",
+		"ai",
+		"codework",
+		"harness",
+		"llm",
+		"plugin",
+		"sdk",
+		"tool"
+	],
+	"homepage": "https://www.codework.sh",
+	"bugs": {
+		"url": "https://github.com/codeworksh/codework/issues"
+	},
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/codeworksh/codework.git",
+		"directory": "packages/plugin"
+	},
+	"type": "module",
+	"types": "./index.d.mts",
+	"exports": {
+		".": {
+			"development": "./src/index.ts",
+			"types": "./index.d.mts",
+			"import": "./index.mjs",
+			"default": "./index.mjs"
+		},
+		"./plugin": {
+			"development": "./src/plugin.ts",
+			"types": "./plugin.d.mts",
+			"import": "./plugin.mjs",
+			"default": "./plugin.mjs"
+		},
+		"./plugin/tool": {
+			"development": "./src/plugin/tool.ts",
+			"types": "./plugin/tool.d.mts",
+			"import": "./plugin/tool.mjs",
+			"default": "./plugin/tool.mjs"
+		},
+		"./plugin/prompt": {
+			"development": "./src/plugin/prompt.ts",
+			"types": "./plugin/prompt.d.mts",
+			"import": "./plugin/prompt.mjs",
+			"default": "./plugin/prompt.mjs"
+		},
+		"./sandbox": {
+			"development": "./src/sandbox.ts",
+			"types": "./sandbox.d.mts",
+			"import": "./sandbox.mjs",
+			"default": "./sandbox.mjs"
+		},
+		"./sandbox/io": {
+			"development": "./src/sandbox/io.ts",
+			"types": "./sandbox/io.d.mts",
+			"import": "./sandbox/io.mjs",
+			"default": "./sandbox/io.mjs"
+		},
+		"./sandbox/driver": {
+			"development": "./src/sandbox/driver.ts",
+			"types": "./sandbox/driver.d.mts",
+			"import": "./sandbox/driver.mjs",
+			"default": "./sandbox/driver.mjs"
+		},
+		"./sandbox/errors": {
+			"development": "./src/sandbox/errors.ts",
+			"types": "./sandbox/errors.d.mts",
+			"import": "./sandbox/errors.mjs",
+			"default": "./sandbox/errors.mjs"
+		},
+		"./sandbox/error": {
+			"development": "./src/sandbox/error.ts",
+			"types": "./sandbox/error.d.mts",
+			"import": "./sandbox/error.mjs",
+			"default": "./sandbox/error.mjs"
+		},
+		"./sandbox/instance": {
+			"development": "./src/sandbox/instance.ts",
+			"types": "./sandbox/instance.d.mts",
+			"import": "./sandbox/instance.mjs",
+			"default": "./sandbox/instance.mjs"
+		},
+		"./sandbox/filesystem": {
+			"development": "./src/sandbox/filesystem.ts",
+			"types": "./sandbox/filesystem.d.mts",
+			"import": "./sandbox/filesystem.mjs",
+			"default": "./sandbox/filesystem.mjs"
+		},
+		"./sandbox/shell": {
+			"development": "./src/sandbox/shell.ts",
+			"types": "./sandbox/shell.d.mts",
+			"import": "./sandbox/shell.mjs",
+			"default": "./sandbox/shell.mjs"
+		},
+		"./sandbox/resource": {
+			"development": "./src/sandbox/resource.ts",
+			"types": "./sandbox/resource.d.mts",
+			"import": "./sandbox/resource.mjs",
+			"default": "./sandbox/resource.mjs"
+		},
+		"./tool": {
+			"development": "./src/tool.ts",
+			"types": "./tool.d.mts",
+			"import": "./tool.mjs",
+			"default": "./tool.mjs"
+		},
+		"./tool/error": {
+			"development": "./src/tool/error.ts",
+			"types": "./tool/error.d.mts",
+			"import": "./tool/error.mjs",
+			"default": "./tool/error.mjs"
+		},
+		"./tool/progress": {
+			"development": "./src/tool/progress.ts",
+			"types": "./tool/progress.d.mts",
+			"import": "./tool/progress.mjs",
+			"default": "./tool/progress.mjs"
+		},
+		"./event": {
+			"development": "./src/event.ts",
+			"types": "./event.d.mts",
+			"import": "./event.mjs",
+			"default": "./event.mjs"
+		},
+		"./ids": {
+			"development": "./src/ids.ts",
+			"types": "./ids.d.mts",
+			"import": "./ids.mjs",
+			"default": "./ids.mjs"
+		},
+		"./location": {
+			"development": "./src/location.ts",
+			"types": "./location.d.mts",
+			"import": "./location.mjs",
+			"default": "./location.mjs"
+		},
+		"./project": {
+			"development": "./src/project.ts",
+			"types": "./project.d.mts",
+			"import": "./project.mjs",
+			"default": "./project.mjs"
+		},
+		"./repo": {
+			"development": "./src/repo.ts",
+			"types": "./repo.d.mts",
+			"import": "./repo.mjs",
+			"default": "./repo.mjs"
+		},
+		"./space": {
+			"development": "./src/space.ts",
+			"types": "./space.d.mts",
+			"import": "./space.mjs",
+			"default": "./space.mjs"
+		},
+		"./settings": {
+			"development": "./src/settings.ts",
+			"types": "./settings.d.mts",
+			"import": "./settings.mjs",
+			"default": "./settings.mjs"
+		},
+		"./schema": {
+			"development": "./src/schema.ts",
+			"types": "./schema.d.mts",
+			"import": "./schema.mjs",
+			"default": "./schema.mjs"
+		},
+		"./posix": {
+			"development": "./src/posix.ts",
+			"types": "./posix.d.mts",
+			"import": "./posix.mjs",
+			"default": "./posix.mjs"
+		},
+		"./package.json": "./package.json"
+	},
+	"files": [
+		"**/*",
+		"README.md",
+		"LICENSE"
+	],
+	"publishConfig": {
+		"access": "public"
+	},
+	"engines": {
+		"node": ">=24.14.1"
+	},
+	"dependencies": {
+		"@codeworksh/aikit": "0.8.0",
+		"tslib": "^2.8.1",
+		"typebox": "^1.3.30",
+		"uuidv7": "^1.2.1"
+	},
+	"peerDependencies": {
+		"effect": "4.0.0-rc.115"
+	}
+}

package/plugin/prompt.d.mts

@@ -0,0 +1,2 @@
+import { t as PromptRegistry } from "../prompt-BcpagjGh.mjs";
+export { PromptRegistry };

package/plugin/prompt.mjs

@@ -0,0 +1,7 @@
+import { t as __exportAll } from "../rolldown-runtime-D7D4PA-g.mjs";
+//#region src/plugin/prompt.ts
+var prompt_exports = /* @__PURE__ */ __exportAll({});
+//#endregion
+export { prompt_exports as t };
+
+//# sourceMappingURL=prompt.mjs.map

package/plugin/prompt.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.mjs","names":[],"sources":["../../../src/plugin/prompt.ts"],"sourcesContent":["export interface PromptRegistry {\n\treadonly set: (systemPrompt: string) => void;\n\treadonly get: () => string | undefined;\n}\n"],"mappings":""}

package/plugin/tool.d.mts

@@ -0,0 +1,2 @@
+import { a as ToolAfterResult, c as ToolBeforeResult, d as ToolRegistry, f as ToolResultContent, i as ToolAfterFn, l as ToolDefPatch, n as ToolAddOptions, o as ToolBefore, r as ToolAfter, s as ToolBeforeFn, t as HookReturn, u as ToolRegistration } from "../tool-BoVqkYvL.mjs";
+export { HookReturn, ToolAddOptions, ToolAfter, ToolAfterFn, ToolAfterResult, ToolBefore, ToolBeforeFn, ToolBeforeResult, ToolDefPatch, ToolRegistration, ToolRegistry, ToolResultContent };

package/plugin/tool.mjs

@@ -0,0 +1,29 @@
+import { t as __exportAll } from "../rolldown-runtime-D7D4PA-g.mjs";
+import { AikitToolCallTerminalPart } from "../event.mjs";
+import { MessageID, SessionID } from "../ids.mjs";
+import { ToolCallContext } from "../tool.mjs";
+import { Schema } from "effect";
+//#region src/plugin/tool.ts
+var tool_exports = /* @__PURE__ */ __exportAll({
+	ToolAfter: () => ToolAfter,
+	ToolBefore: () => ToolBefore,
+	ToolBeforeResult: () => ToolBeforeResult
+});
+const ToolBefore = Schema.Struct({
+	...ToolCallContext.fields,
+	sessionId: SessionID,
+	messageId: MessageID,
+	params: Schema.Unknown
+});
+const ToolAfter = Schema.Struct({
+	...ToolBefore.fields,
+	terminal: AikitToolCallTerminalPart
+});
+const ToolBeforeResult = Schema.Struct({
+	block: Schema.Boolean,
+	reason: Schema.optional(Schema.String)
+});
+//#endregion
+export { ToolAfter, ToolBefore, ToolBeforeResult, tool_exports as t };
+
+//# sourceMappingURL=tool.mjs.map

package/plugin/tool.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.mjs","names":[],"sources":["../../../src/plugin/tool.ts"],"sourcesContent":["import { type Effect, Schema } from \"effect\";\nimport { AikitToolCallTerminalPart } from \"../event.ts\";\nimport { MessageID, SessionID } from \"../ids.ts\";\nimport { type AnyToolDef, type ModelContent, type RegisteredTool, ToolCallContext } from \"../tool.ts\";\n\nexport const ToolBefore = Schema.Struct({\n\t...ToolCallContext.fields,\n\tsessionId: SessionID,\n\tmessageId: MessageID,\n\tparams: Schema.Unknown,\n});\nexport type ToolBefore = typeof ToolBefore.Type;\nexport const ToolAfter = Schema.Struct({ ...ToolBefore.fields, terminal: AikitToolCallTerminalPart });\nexport type ToolAfter = typeof ToolAfter.Type;\nexport const ToolBeforeResult = Schema.Struct({ block: Schema.Boolean, reason: Schema.optional(Schema.String) });\nexport type ToolBeforeResult = typeof ToolBeforeResult.Type;\nexport type ToolResultContent = ModelContent;\nexport interface ToolAfterResult {\n\treadonly content?: ToolResultContent;\n\treadonly details?: unknown;\n\treadonly isError?: boolean;\n}\nexport type HookReturn<A> = A | void | Promise<A | void> | Effect.Effect<A | void, unknown>;\nexport type ToolBeforeFn = (call: ToolBefore) => HookReturn<ToolBeforeResult>;\nexport type ToolAfterFn = (call: ToolAfter) => HookReturn<ToolAfterResult>;\nexport interface ToolAddOptions {\n\treadonly beforeToolCall?: ToolBeforeFn;\n\treadonly afterToolCall?: ToolAfterFn;\n}\nexport interface ToolDefPatch {\n\treadonly description?: string;\n\treadonly label?: string;\n\treadonly promptSnippet?: string;\n\treadonly promptGuidelines?: ReadonlyArray<string>;\n}\n/**\n * One frozen bucket entry: the winning tool for a name together with the hooks that\n * `add` declared alongside it. Kept here rather than in the bucket implementation so\n * the executor shares the contract without importing plugin assembly.\n */\nexport interface ToolRegistration {\n\treadonly tool: RegisteredTool;\n\treadonly hooks: ToolAddOptions;\n}\nexport interface ToolRegistry {\n\treadonly add: (tool: RegisteredTool, options?: ToolAddOptions) => void;\n\treadonly update: (name: string, patch: ToolDefPatch) => void;\n\treadonly list: () => ReadonlyArray<AnyToolDef>;\n\treadonly get: (name: string) => AnyToolDef | undefined;\n\treadonly has: (name: string) => boolean;\n}\n"],"mappings":";;;;;;;;;;;AAKA,MAAa,aAAa,OAAO,OAAO;CACvC,GAAG,gBAAgB;CACnB,WAAW;CACX,WAAW;CACX,QAAQ,OAAO;AAChB,CAAC;AAED,MAAa,YAAY,OAAO,OAAO;CAAE,GAAG,WAAW;CAAQ,UAAU;AAA0B,CAAC;AAEpG,MAAa,mBAAmB,OAAO,OAAO;CAAE,OAAO,OAAO;CAAS,QAAQ,OAAO,SAAS,OAAO,MAAM;AAAE,CAAC"}

package/plugin-DbJEpY3M.d.mts

@@ -0,0 +1,140 @@
+import { i as Definition, o as Payload, r as Data, s as PublishOptions } from "./event-rIZpnOTo.mjs";
+import { n as SessionID } from "./ids-CHjmAdTc.mjs";
+import { r as Info, s as Service } from "./location-D4hAfuXF.mjs";
+import { a as Provides, r as Identity, u as io_d_exports } from "./io-BYs7hbiY.mjs";
+import { r as Info$1 } from "./settings-CYL6yyDD.mjs";
+import { n as prompt_d_exports, t as PromptRegistry } from "./prompt-BcpagjGh.mjs";
+import { d as ToolRegistry, p as tool_d_exports } from "./tool-BoVqkYvL.mjs";
+import { Model } from "@codeworksh/aikit";
+import { Effect } from "effect";
+//#region src/plugin/registry.d.ts
+/**
+ * What a plugin writes into during `setup`: one registry per domain.
+ *
+ * The buckets are open for the duration of the setup pass and frozen after it, so a plugin holds
+ * the object only as long as writing to it means anything. Assembling the frozen snapshot — the
+ * effective tool catalog and the final system prompt — is the harness's job, not the contract's.
+ */
+interface PluginRegistry {
+  readonly tools: ToolRegistry;
+  readonly prompt: PromptRegistry;
+}
+//#endregion
+//#region src/plugin/context.d.ts
+type PromptResolver = (ctx: SharedPluginContext) => string | Promise<string>;
+interface Config {
+  readonly promptCustom?: PromptResolver;
+  readonly promptSystemAppend?: PromptResolver;
+}
+/**
+ * The publish half of the harness event bus.
+ *
+ * Narrowed to `publish` on purpose: a plugin announces what it did, it does not read the journal.
+ * Kernel event types are reserved — the harness rejects a plugin publishing one — so a plugin's
+ * own definitions must be namespaced `plugin.<id>.*`.
+ */
+interface Events {
+  readonly publish: <D extends Definition>(definition: D, data: Data<D>, options?: PublishOptions) => Effect.Effect<Payload<D>>;
+}
+/** One object, shared by every plugin in one exchange. */
+interface SharedPluginContext {
+  readonly sessionId: SessionID;
+  readonly sandbox: Identity;
+  readonly location: Info;
+  readonly settings: Info$1;
+  readonly model: Model.Info;
+  readonly config: Config;
+  readonly events: Events;
+  readonly plugin: PluginRegistry;
+}
+//#endregion
+//#region src/plugin/ref.d.ts
+/**
+ * How a plugin is named in a `plugins` array, and what the harness does with each shape.
+ *
+ * The array is the whole configuration surface: an entry either *selects* a module or
+ * *configures* one something else already selected. Nothing else is required of a plugin author,
+ * which is why the shapes live in this package rather than in the loader that consumes them.
+ */
+/** Opaque to the harness: a plugin reads and validates its own block. */
+type PluginOptions = {
+  readonly [key: string]: unknown;
+};
+/** A module to load: a path, a `file:` URL, or a package spec. Definitions are passed directly. */
+type PluginSpec = Plugin | string;
+interface PluginConfig {
+  /** `false` drops the plugin from the selection. */
+  readonly enabled?: boolean | undefined;
+  readonly options?: PluginOptions | undefined;
+}
+/**
+ * Configuration for a plugin something else already selected, naming it by ID (`plugin`) or by
+ * the module string it was registered from (`package`) — exactly one of the two. It loads nothing,
+ * so a name matching nothing in the selection is ignored rather than fetched.
+ */
+type PluginPatch = (PluginConfig & {
+  readonly plugin: string;
+  readonly package?: never;
+}) | (PluginConfig & {
+  readonly package: string;
+  readonly plugin?: never;
+});
+type PluginRef = PluginSpec | PluginPatch;
+//#endregion
+//#region src/plugin/plugin.d.ts
+/**
+ * The domains a plugin can extend, and the order the harness runs them in.
+ *
+ * Order is declared, not positional. A plugin's place used to come from where its entry sat in
+ * the `plugins` array, which is unknowable when the entry is written: a user's settings file and
+ * a project's are edited by different people at different times, and neither can see the other's
+ * order. Since a prompt plugin indexes the tools registered before it, that made a tool added
+ * from settings invisible in the system prompt, with no way to fix it from a settings file.
+ *
+ * A plugin instead says which domain it extends, and the harness runs the domains in this order.
+ * Entries within one domain keep the order they were written in, because that is where
+ * composition actually happens -- a plugin patching another's tool, or appending to the prompt a
+ * previous one rendered, is written next to it and deliberately after it.
+ *
+ * Kept as data so a later release can add a domain, or make the order configurable, without
+ * touching the loader: `{ tool: 1, skill: 2, prompt: 3 }` needs no code change here.
+ */
+declare const domains: {
+  readonly tool: 1;
+  readonly prompt: 2;
+};
+type PluginKind = keyof typeof domains;
+/** Sort key for a plugin: its domain first, then where it was written. */
+declare const rank: (kind: PluginKind) => 1 | 2;
+type Mount = Provides | Service;
+interface Plugin {
+  readonly id: string;
+  /**
+   * The domain this plugin extends, which decides when it runs: every `tool` plugin is set up
+   * before any `prompt` plugin, whichever settings layer each came from, so a prompt plugin
+   * always sees the complete tool set. Plugins within one domain run in the order they were
+   * written.
+   */
+  readonly kind: PluginKind;
+  /**
+   * Event definitions this plugin publishes. Declared rather than registered at
+   * runtime so they are known before the event system builds, and so a bad type
+   * fails the boot instead of the first publish. Types must be namespaced
+   * `plugin.<id>.*`.
+   */
+  readonly events?: ReadonlyArray<Definition>;
+  /**
+   * `options` is this plugin's own configuration block, `{}` when its entry carried none.
+   * Unvalidated: the harness never looks inside it, so a plugin checks whatever shape it
+   * documents. It is a second argument rather than a context field so `ctx` stays one object
+   * shared by every plugin in the exchange.
+   */
+  readonly setup: (ctx: SharedPluginContext, options: PluginOptions) => void | Promise<void> | Effect.Effect<void, unknown, Mount>;
+}
+declare const define: (plugin: Plugin) => Plugin;
+declare namespace plugin_d_exports {
+  export { Config, Events, Mount, Plugin, PluginKind, PluginOptions, PluginPatch, PluginRef, PluginRegistry, PluginSpec, prompt_d_exports as Prompt, PromptResolver, SharedPluginContext, tool_d_exports as Tool, define, domains, rank };
+}
+//#endregion
+export { define as a, PluginOptions as c, PluginSpec as d, Config as f, PluginRegistry as g, SharedPluginContext as h, PluginKind as i, PluginPatch as l, PromptResolver as m, Mount as n, domains as o, Events as p, Plugin as r, rank as s, plugin_d_exports as t, PluginRef as u };
+//# sourceMappingURL=plugin-DbJEpY3M.d.mts.map

package/plugin-lorpq7Oi.mjs

@@ -0,0 +1,41 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
+import { t as prompt_exports } from "./plugin/prompt.mjs";
+import { t as tool_exports } from "./plugin/tool.mjs";
+//#region src/plugin/plugin.ts
+/**
+* The domains a plugin can extend, and the order the harness runs them in.
+*
+* Order is declared, not positional. A plugin's place used to come from where its entry sat in
+* the `plugins` array, which is unknowable when the entry is written: a user's settings file and
+* a project's are edited by different people at different times, and neither can see the other's
+* order. Since a prompt plugin indexes the tools registered before it, that made a tool added
+* from settings invisible in the system prompt, with no way to fix it from a settings file.
+*
+* A plugin instead says which domain it extends, and the harness runs the domains in this order.
+* Entries within one domain keep the order they were written in, because that is where
+* composition actually happens -- a plugin patching another's tool, or appending to the prompt a
+* previous one rendered, is written next to it and deliberately after it.
+*
+* Kept as data so a later release can add a domain, or make the order configurable, without
+* touching the loader: `{ tool: 1, skill: 2, prompt: 3 }` needs no code change here.
+*/
+const domains = {
+	tool: 1,
+	prompt: 2
+};
+/** Sort key for a plugin: its domain first, then where it was written. */
+const rank = (kind) => domains[kind];
+const define = (plugin) => plugin;
+//#endregion
+//#region src/plugin.ts
+var plugin_exports = /* @__PURE__ */ __exportAll({
+	Prompt: () => prompt_exports,
+	Tool: () => tool_exports,
+	define: () => define,
+	domains: () => domains,
+	rank: () => rank
+});
+//#endregion
+export { rank as i, define as n, domains as r, plugin_exports as t };
+
+//# sourceMappingURL=plugin-lorpq7Oi.mjs.map

package/plugin-lorpq7Oi.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-lorpq7Oi.mjs","names":[],"sources":["../../src/plugin/plugin.ts","../../src/plugin.ts"],"sourcesContent":["import type { Effect } from \"effect\";\nimport type { Definition } from \"../event.ts\";\nimport type { Service as LocationService } from \"../location.ts\";\nimport type { SandboxIO } from \"../sandbox/io.ts\";\nimport type { PluginOptions } from \"./ref.ts\";\nimport type { SharedPluginContext } from \"./context.ts\";\n\n/**\n * The domains a plugin can extend, and the order the harness runs them in.\n *\n * Order is declared, not positional. A plugin's place used to come from where its entry sat in\n * the `plugins` array, which is unknowable when the entry is written: a user's settings file and\n * a project's are edited by different people at different times, and neither can see the other's\n * order. Since a prompt plugin indexes the tools registered before it, that made a tool added\n * from settings invisible in the system prompt, with no way to fix it from a settings file.\n *\n * A plugin instead says which domain it extends, and the harness runs the domains in this order.\n * Entries within one domain keep the order they were written in, because that is where\n * composition actually happens -- a plugin patching another's tool, or appending to the prompt a\n * previous one rendered, is written next to it and deliberately after it.\n *\n * Kept as data so a later release can add a domain, or make the order configurable, without\n * touching the loader: `{ tool: 1, skill: 2, prompt: 3 }` needs no code change here.\n */\nexport const domains = { tool: 1, prompt: 2 } as const;\n\nexport type PluginKind = keyof typeof domains;\n\n/** Sort key for a plugin: its domain first, then where it was written. */\nexport const rank = (kind: PluginKind) => domains[kind];\n\nexport type Mount = SandboxIO.Provides | LocationService;\nexport interface Plugin {\n\treadonly id: string;\n\t/**\n\t * The domain this plugin extends, which decides when it runs: every `tool` plugin is set up\n\t * before any `prompt` plugin, whichever settings layer each came from, so a prompt plugin\n\t * always sees the complete tool set. Plugins within one domain run in the order they were\n\t * written.\n\t */\n\treadonly kind: PluginKind;\n\t/**\n\t * Event definitions this plugin publishes. Declared rather than registered at\n\t * runtime so they are known before the event system builds, and so a bad type\n\t * fails the boot instead of the first publish. Types must be namespaced\n\t * `plugin.<id>.*`.\n\t */\n\treadonly events?: ReadonlyArray<Definition>;\n\t/**\n\t * `options` is this plugin's own configuration block, `{}` when its entry carried none.\n\t * Unvalidated: the harness never looks inside it, so a plugin checks whatever shape it\n\t * documents. It is a second argument rather than a context field so `ctx` stays one object\n\t * shared by every plugin in the exchange.\n\t */\n\treadonly setup: (\n\t\tctx: SharedPluginContext,\n\t\toptions: PluginOptions,\n\t) => void | Promise<void> | Effect.Effect<void, unknown, Mount>;\n}\n\nexport const define = (plugin: Plugin): Plugin => plugin;\n","/**\n * The plugin authoring surface.\n *\n * Everything a third-party plugin needs to describe itself and to write into the harness during\n * `setup`, and nothing about how the harness finds, installs or runs it. Loading, the store and\n * the `.npmrc` anchoring stay in `@codeworksh/harness`, which imports this same module — so a\n * plugin and its host agree on one set of types rather than two that happen to match.\n */\nexport type { Config, Events, PromptResolver, SharedPluginContext } from \"./plugin/context.ts\";\nexport { define, domains, type Mount, type Plugin, type PluginKind, rank } from \"./plugin/plugin.ts\";\nexport * as Prompt from \"./plugin/prompt.ts\";\nexport type { PluginOptions, PluginPatch, PluginRef, PluginSpec } from \"./plugin/ref.ts\";\nexport type { PluginRegistry } from \"./plugin/registry.ts\";\nexport * as Tool from \"./plugin/tool.ts\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAwBA,MAAa,UAAU;CAAE,MAAM;CAAG,QAAQ;AAAE;;AAK5C,MAAa,QAAQ,SAAqB,QAAQ;AA+BlD,MAAa,UAAU,WAA2B"}

package/plugin.d.mts

@@ -0,0 +1,4 @@
+import { n as prompt_d_exports } from "./prompt-BcpagjGh.mjs";
+import { p as tool_d_exports } from "./tool-BoVqkYvL.mjs";
+import { a as define, c as PluginOptions, d as PluginSpec, f as Config, g as PluginRegistry, h as SharedPluginContext, i as PluginKind, l as PluginPatch, m as PromptResolver, n as Mount, o as domains, p as Events, r as Plugin, s as rank, u as PluginRef } from "./plugin-DbJEpY3M.mjs";
+export { type Config, type Events, type Mount, type Plugin, type PluginKind, type PluginOptions, type PluginPatch, type PluginRef, type PluginRegistry, type PluginSpec, prompt_d_exports as Prompt, type PromptResolver, type SharedPluginContext, tool_d_exports as Tool, define, domains, rank };

package/plugin.mjs

@@ -0,0 +1,4 @@
+import { i as rank, n as define, r as domains } from "./plugin-lorpq7Oi.mjs";
+import { t as prompt_exports } from "./plugin/prompt.mjs";
+import { t as tool_exports } from "./plugin/tool.mjs";
+export { prompt_exports as Prompt, tool_exports as Tool, define, domains, rank };

package/posix.d.mts

@@ -0,0 +1,6 @@
+import { Path } from "effect";
+//#region src/posix.d.ts
+/** Shared POSIX path implementation for sandbox and remote-runtime paths. */
+export declare const posix: Path.Path;
+//#endregion
+//# sourceMappingURL=posix.d.mts.map

package/posix.mjs

@@ -0,0 +1,8 @@
+import { Effect, Path } from "effect";
+//#region src/posix.ts
+/** Shared POSIX path implementation for sandbox and remote-runtime paths. */
+const posix = Effect.runSync(Path.Path.pipe(Effect.provide(Path.layer)));
+//#endregion
+export { posix };
+
+//# sourceMappingURL=posix.mjs.map

package/posix.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"posix.mjs","names":[],"sources":["../../src/posix.ts"],"sourcesContent":["import { Effect, Path } from \"effect\";\n\n/** Shared POSIX path implementation for sandbox and remote-runtime paths. */\nexport const posix = Effect.runSync(Path.Path.pipe(Effect.provide(Path.layer)));\n"],"mappings":";;;AAGA,MAAa,QAAQ,OAAO,QAAQ,KAAK,KAAK,KAAK,OAAO,QAAQ,KAAK,KAAK,CAAC,CAAC"}

package/project-CLGsIFD-.d.mts

@@ -0,0 +1,21 @@
+import { Schema } from "effect";
+declare namespace project_d_exports {
+  export { ID, Info, project_d_exports as ProjectSchema, Status };
+}
+declare const ID: Schema.brand<Schema.String, "Project.ID">;
+type ID = typeof ID.Type;
+declare const Status: Schema.Literals<readonly ["active", "archived"]>;
+type Status = typeof Status.Type;
+declare const Info_base: Schema.Class<Info, Schema.Struct<{
+  readonly id: Schema.brand<Schema.String, "Project.ID">;
+  readonly name: Schema.String;
+  readonly status: Schema.Literals<readonly ["active", "archived"]>;
+  readonly vcs: Schema.optional<Schema.Union<readonly [Schema.Struct<{
+    readonly type: Schema.Literal<"git">;
+    readonly store: Schema.brand<Schema.String, "AbsolutePath">;
+  }>]>>;
+}>, {}>;
+declare class Info extends Info_base {}
+//#endregion
+export { project_d_exports as i, Info as n, Status as r, ID as t };
+//# sourceMappingURL=project-CLGsIFD-.d.mts.map

package/project.d.mts

@@ -0,0 +1,2 @@
+import { i as project_d_exports, n as Info, r as Status, t as ID } from "./project-CLGsIFD-.mjs";
+export { ID, Info, project_d_exports as ProjectSchema, Status };

package/project.mjs

@@ -0,0 +1,22 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
+import { Vcs } from "./repo.mjs";
+import { Schema } from "effect";
+//#region src/project.ts
+var project_exports = /* @__PURE__ */ __exportAll({
+	ID: () => ID,
+	Info: () => Info,
+	ProjectSchema: () => project_exports,
+	Status: () => Status
+});
+const ID = Schema.String.pipe(Schema.brand("Project.ID"));
+const Status = Schema.Literals(["active", "archived"]);
+var Info = class extends Schema.Class("Project.Info")({
+	id: ID,
+	name: Schema.String,
+	status: Status,
+	vcs: Schema.optional(Vcs)
+}) {};
+//#endregion
+export { ID, Info, project_exports as ProjectSchema, Status };
+
+//# sourceMappingURL=project.mjs.map

package/project.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.mjs","names":["RepoSchema.Vcs"],"sources":["../../src/project.ts"],"sourcesContent":["import { Schema } from \"effect\";\nimport { RepoSchema } from \"./repo.ts\";\n\n// Env-independent project id: marker ?? remoteHash ?? rootCommit ?? provisional.\nexport const ID = Schema.String.pipe(Schema.brand(\"Project.ID\"));\nexport type ID = typeof ID.Type;\n\n// A project is archived, never deleted, once it has no active space anywhere.\nexport const Status = Schema.Literals([\"active\", \"archived\"]);\nexport type Status = typeof Status.Type;\n\nexport class Info extends Schema.Class<Info>(\"Project.Info\")({\n\tid: ID,\n\tname: Schema.String,\n\tstatus: Status,\n\tvcs: Schema.optional(RepoSchema.Vcs),\n}) {}\n\nexport * as ProjectSchema from \"./project.ts\";\n"],"mappings":";;;;;;;;;;AAIA,MAAa,KAAK,OAAO,OAAO,KAAK,OAAO,MAAM,YAAY,CAAC;AAI/D,MAAa,SAAS,OAAO,SAAS,CAAC,UAAU,UAAU,CAAC;AAG5D,IAAa,OAAb,cAA0B,OAAO,MAAY,cAAc,CAAC,CAAC;CAC5D,IAAI;CACJ,MAAM,OAAO;CACb,QAAQ;CACR,KAAK,OAAO,SAASA,GAAc;AACpC,CAAC,CAAC,CAAC,CAAC"}

package/prompt-BcpagjGh.d.mts

@@ -0,0 +1,10 @@
+declare namespace prompt_d_exports {
+  export { PromptRegistry };
+}
+interface PromptRegistry {
+  readonly set: (systemPrompt: string) => void;
+  readonly get: () => string | undefined;
+}
+//#endregion
+export { prompt_d_exports as n, PromptRegistry as t };
+//# sourceMappingURL=prompt-BcpagjGh.d.mts.map

package/repo.d.mts

@@ -0,0 +1,42 @@
+import { Schema } from "effect";
+declare namespace repo_d_exports {
+  export { Info, repo_d_exports as RepoSchema, Vcs };
+}
+export declare const Vcs: Schema.Union<readonly [Schema.Struct<{
+  readonly type: Schema.Literal<"git">;
+  readonly store: Schema.brand<Schema.String, "AbsolutePath">;
+}>]>;
+export type Vcs = typeof Vcs.Type;
+export declare const Info: Schema.Struct<{
+  /**
+   * The root directory of the working tree that contains the input path
+   * (`rev-parse --show-toplevel`).
+   *
+   * For `/home/me/app/src/file.ts` in a normal clone, this is `/home/me/app`.
+   * For `/home/me/app-feature/src/file.ts` in a linked worktree, this is
+   * `/home/me/app-feature`.
+   */
+  readonly directory: Schema.brand<Schema.String, "AbsolutePath">;
+  /**
+   * This checkout's own git directory (`rev-parse --git-dir`).
+   *
+   * For a normal clone at `/home/me/app`, this is `/home/me/app/.git`. For a
+   * linked worktree it lives under the store, e.g.
+   * `/home/me/app/.git/worktrees/app-feature`. `gitDir === store` iff this is
+   * the main checkout.
+   */
+  readonly gitDir: Schema.brand<Schema.String, "AbsolutePath">;
+  /**
+   * The shared Git storage directory used by this repo and any linked
+   * worktrees (`rev-parse --git-common-dir`).
+   *
+   * For a normal clone at `/home/me/app`, this is usually `/home/me/app/.git`.
+   * For a linked worktree at `/home/me/app-feature` whose main checkout is
+   * `/home/me/app`, this is usually `/home/me/app/.git`.
+   */
+  readonly store: Schema.brand<Schema.String, "AbsolutePath">;
+}>;
+export type Info = typeof Info.Type;
+//#endregion
+export { repo_d_exports as RepoSchema };
+//# sourceMappingURL=repo.d.mts.map

package/repo.mjs

@@ -0,0 +1,46 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
+import { AbsolutePath } from "./schema.mjs";
+import { Schema } from "effect";
+//#region src/repo.ts
+var repo_exports = /* @__PURE__ */ __exportAll({
+	Info: () => Info,
+	RepoSchema: () => repo_exports,
+	Vcs: () => Vcs
+});
+const Vcs = Schema.Union([Schema.Struct({
+	type: Schema.Literal("git"),
+	store: AbsolutePath
+})]);
+const Info = Schema.Struct({
+	/**
+	* The root directory of the working tree that contains the input path
+	* (`rev-parse --show-toplevel`).
+	*
+	* For `/home/me/app/src/file.ts` in a normal clone, this is `/home/me/app`.
+	* For `/home/me/app-feature/src/file.ts` in a linked worktree, this is
+	* `/home/me/app-feature`.
+	*/
+	directory: AbsolutePath,
+	/**
+	* This checkout's own git directory (`rev-parse --git-dir`).
+	*
+	* For a normal clone at `/home/me/app`, this is `/home/me/app/.git`. For a
+	* linked worktree it lives under the store, e.g.
+	* `/home/me/app/.git/worktrees/app-feature`. `gitDir === store` iff this is
+	* the main checkout.
+	*/
+	gitDir: AbsolutePath,
+	/**
+	* The shared Git storage directory used by this repo and any linked
+	* worktrees (`rev-parse --git-common-dir`).
+	*
+	* For a normal clone at `/home/me/app`, this is usually `/home/me/app/.git`.
+	* For a linked worktree at `/home/me/app-feature` whose main checkout is
+	* `/home/me/app`, this is usually `/home/me/app/.git`.
+	*/
+	store: AbsolutePath
+});
+//#endregion
+export { Info, repo_exports as RepoSchema, Vcs };
+
+//# sourceMappingURL=repo.mjs.map

package/repo.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo.mjs","names":[],"sources":["../../src/repo.ts"],"sourcesContent":["import { Schema } from \"effect\";\nimport { AbsolutePath } from \"./schema.ts\";\n\n// Identified vcs type and its shared storage path.\n// Example: `{ type: \"git\", store: \"/app/code/.git\" }`\nexport const Vcs = Schema.Union([\n\tSchema.Struct({\n\t\ttype: Schema.Literal(\"git\"),\n\t\tstore: AbsolutePath,\n\t}),\n]);\nexport type Vcs = typeof Vcs.Type;\n\n// A discovered git repository. Every path is realpath'd.\nexport const Info = Schema.Struct({\n\t/**\n\t * The root directory of the working tree that contains the input path\n\t * (`rev-parse --show-toplevel`).\n\t *\n\t * For `/home/me/app/src/file.ts` in a normal clone, this is `/home/me/app`.\n\t * For `/home/me/app-feature/src/file.ts` in a linked worktree, this is\n\t * `/home/me/app-feature`.\n\t */\n\tdirectory: AbsolutePath,\n\t/**\n\t * This checkout's own git directory (`rev-parse --git-dir`).\n\t *\n\t * For a normal clone at `/home/me/app`, this is `/home/me/app/.git`. For a\n\t * linked worktree it lives under the store, e.g.\n\t * `/home/me/app/.git/worktrees/app-feature`. `gitDir === store` iff this is\n\t * the main checkout.\n\t */\n\tgitDir: AbsolutePath,\n\t/**\n\t * The shared Git storage directory used by this repo and any linked\n\t * worktrees (`rev-parse --git-common-dir`).\n\t *\n\t * For a normal clone at `/home/me/app`, this is usually `/home/me/app/.git`.\n\t * For a linked worktree at `/home/me/app-feature` whose main checkout is\n\t * `/home/me/app`, this is usually `/home/me/app/.git`.\n\t */\n\tstore: AbsolutePath,\n});\nexport type Info = typeof Info.Type;\n\nexport * as RepoSchema from \"./repo.ts\";\n"],"mappings":";;;;;;;;;AAKA,MAAa,MAAM,OAAO,MAAM,CAC/B,OAAO,OAAO;CACb,MAAM,OAAO,QAAQ,KAAK;CAC1B,OAAO;AACR,CAAC,CACF,CAAC;AAID,MAAa,OAAO,OAAO,OAAO;;;;;;;;;CASjC,WAAW;;;;;;;;;CASX,QAAQ;;;;;;;;;CASR,OAAO;AACR,CAAC"}