dsh-plugin-dev-kb 1.6.0 → 1.8.1

package/kb/site/en/reference/cordis-api/fiber.md

@@ -1,380 +1,457 @@
----
-editSource: "docs/cordis-api/fiber.md"
-rawMarkdownPath: "en/reference/cordis-api/fiber.md"
----
-
-<!-- Generated by scripts/gen-cordis-catalog.ts — do not edit by hand.
-     Run `pnpm run gen-cordis-catalog` to regenerate. -->
-
-# Fiber
-
-A fiber is one loaded plugin instance: its lifecycle state, validated config, and registered effects. `ctx.fiber` is the current fiber, and `ctx.effect()` delegates to it.
-
-### ctx.effect(execute, label?)
-
-```ts cordis-catalog
-/**
- * Register a cleanup-aware effect on this fiber.
- *
- * `execute` runs immediately; the disposers it produces are collected and
- * run (in reverse order) either when the returned disposer is called or
- * when the fiber unloads, whichever comes first. Calling the disposer twice
- * is a no-op. Throws `CordisError('INACTIVE_EFFECT')` if the fiber is
- * already disposed, and `TypeError` if `execute` returns an invalid shape.
- *
- * @param execute — the effect body; see {@link Effect} for accepted shapes.
- * @param label — effect label shown in `getEffects()` diagnostics.
- * @returns a disposer that tears the effect down and settles once done.
- */
-effect(execute: () => SyncEffect, label?: string): Disposable<Promise<void>>
-effect(execute: () => Effect, label?: string): AsyncDisposable<Promise<void>>
-```
-
-Register a cleanup-aware effect on this fiber.
-
-`execute` runs immediately; the disposers it produces are collected and run (in reverse order) either when the returned disposer is called or when the fiber unloads, whichever comes first. Calling the disposer twice is a no-op. Throws `CordisError('INACTIVE_EFFECT')` if the fiber is already disposed, and `TypeError` if `execute` returns an invalid shape.
-
-- `execute` — the effect body; see `Effect` for accepted shapes.
-- `label` — effect label shown in `getEffects()` diagnostics.
-
-**Returns** a disposer that tears the effect down and settles once done.
-
-[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L415)
-
-### ctx.fiber
-
-```ts cordis-catalog
-/** The fiber (plugin runtime instance) that owns this context. */
-fiber: Fiber
-```
-
-The fiber (plugin runtime instance) that owns this context.
-
-[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L12)
-
-## The Fiber class
-
-Runtime instance of one plugin application.
-
-A fiber tracks dependency state, validated config, lifecycle effects, and cleanup for the plugin context returned by `ctx.plugin()`.
-
-[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L184)
-
-### fiber.uid
-
-```ts cordis-catalog
-/** Unique id within the registry; 0 for the root fiber, `null` once disposed. */
-public uid: number | null
-```
-
-Unique id within the registry; 0 for the root fiber, `null` once disposed.
-
-[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L186)
-
-### fiber.ctx
-
-```ts cordis-catalog
-/** The context this fiber's plugin runs in (extends the parent context). */
-public readonly ctx: Context
-```
-
-The context this fiber's plugin runs in (extends the parent context).
-
-[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L188)
-
-### fiber.config
-
-```ts cordis-catalog
-/** The validated plugin config (updated by `update()`). */
-public config: any
-```
-
-The validated plugin config (updated by `update()`).
-
-[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L190)
-
-### fiber.state
-
-```ts cordis-catalog
-/** Current lifecycle state; transitions emit `internal/status`. */
-public state
-```
-
-Current lifecycle state; transitions emit `internal/status`.
-
-[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L194)
-
-### fiber.dispose
-
-```ts cordis-catalog
-/** Dispose this fiber: unload the plugin, then settle once cleanup finished. */
-public readonly dispose: () => Promise<void>
-```
-
-Dispose this fiber: unload the plugin, then settle once cleanup finished.
-
-[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L196)
-
-### fiber.store
-
-```ts cordis-catalog
-/** Snapshot of required service implementations while loaded; `undefined` otherwise. */
-public store: Dict<Impl> | undefined
-```
-
-Snapshot of required service implementations while loaded; `undefined` otherwise.
-
-[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L198)
-
-### fiber.inertia
-
-```ts cordis-catalog
-/** The in-flight load/unload transition, if one is currently running. */
-public inertia: Promise<void> | undefined
-```
-
-The in-flight load/unload transition, if one is currently running.
-
-[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L200)
-
-### fiber.name
-
-```ts cordis-catalog
-/** The plugin's display name, inherited from the nearest named ancestor, else `'root'`. */
-get name()
-```
-
-The plugin's display name, inherited from the nearest named ancestor, else `'root'`.
-
-[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L336)
-
-### fiber.assertActive()
-
-```ts cordis-catalog
-/**
- * Throw if the fiber has already been disposed.
- *
- * @returns nothing when the fiber is still active.
- * @throws {CordisError} `INACTIVE_EFFECT` when the fiber's uid has been cleared.
- */
-assertActive()
-```
-
-Throw if the fiber has already been disposed.
-
-**Returns** nothing when the fiber is still active.
-
-[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L351)
-
-### fiber.effect(execute, label?)
-
-```ts cordis-catalog
-/**
- * Register a cleanup-aware effect on this fiber.
- *
- * `execute` runs immediately; the disposers it produces are collected and
- * run (in reverse order) either when the returned disposer is called or
- * when the fiber unloads, whichever comes first. Calling the disposer twice
- * is a no-op. Throws `CordisError('INACTIVE_EFFECT')` if the fiber is
- * already disposed, and `TypeError` if `execute` returns an invalid shape.
- *
- * @param execute — the effect body; see {@link Effect} for accepted shapes.
- * @param label — effect label shown in `getEffects()` diagnostics.
- * @returns a disposer that tears the effect down and settles once done.
- */
-effect(execute: () => SyncEffect, label?: string): Disposable<Promise<void>>
-effect(execute: () => Effect, label?: string): AsyncDisposable<Promise<void>>
-```
-
-Register a cleanup-aware effect on this fiber.
-
-`execute` runs immediately; the disposers it produces are collected and run (in reverse order) either when the returned disposer is called or when the fiber unloads, whichever comes first. Calling the disposer twice is a no-op. Throws `CordisError('INACTIVE_EFFECT')` if the fiber is already disposed, and `TypeError` if `execute` returns an invalid shape.
-
-- `execute` — the effect body; see `Effect` for accepted shapes.
-- `label` — effect label shown in `getEffects()` diagnostics.
-
-**Returns** a disposer that tears the effect down and settles once done.
-
-[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L415)
-
-### fiber.getEffects()
-
-```ts cordis-catalog
-/**
- * Return metadata for currently registered effects.
- *
- * @returns one {@link EffectMeta} tree per labeled live effect.
- */
-getEffects()
-```
-
-Return metadata for currently registered effects.
-
-**Returns** one `EffectMeta` tree per labeled live effect.
-
-[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L568)
-
-### fiber.await()
-
-```ts cordis-catalog
-/**
- * Wait for current lifecycle work and rethrow startup errors.
- *
- * @returns this fiber, once it has settled into a stable state.
- * @throws the config-validation or plugin-startup error, if any.
- */
-async await()
-```
-
-Wait for current lifecycle work and rethrow startup errors.
-
-**Returns** this fiber, once it has settled into a stable state.
-
-[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L704)
-
-### fiber.restart()
-
-```ts cordis-catalog
-/**
- * Dispose and immediately reload this plugin with its current config.
- *
- * @returns a promise resolving once the reload settled.
- * @throws {CordisError} `INACTIVE_EFFECT` when the fiber is already disposed.
- */
-async restart()
-```
-
-Dispose and immediately reload this plugin with its current config.
-
-**Returns** a promise resolving once the reload settled.
-
-[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L718)
-
-### fiber.update(config, noSave?)
-
-```ts cordis-catalog
-/**
- * Validate and apply new config, then restart the plugin.
- *
- * Runs the `internal/update` waterfall first, so update hooks (and HMR)
- * can veto or replace the restart.
- *
- * @param config — the new raw config; validated before anything restarts.
- * @param noSave — hint for persistence hooks not to write the change back.
- * @returns nothing; the restart runs behind the `internal/update` waterfall.
- * @throws {ValidationError} when the new config fails validation.
- */
-update(config: any, noSave = false)
-```
-
-Validate and apply new config, then restart the plugin.
-
-Runs the `internal/update` waterfall first, so update hooks (and HMR) can veto or replace the restart.
-
-- `config` — the new raw config; validated before anything restarts.
-- `noSave` — hint for persistence hooks not to write the change back.
-
-**Returns** nothing; the restart runs behind the `internal/update` waterfall.
-
-[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L736)
-
-## Effect
-
-Effect body result accepted by `ctx.effect()` and plugin startup.
-
-Either a single disposer, a promise of one, or a (possibly async) iterable yielding several — generator effects register each yielded disposer as it is produced.
-
-```ts cordis-catalog
-/**
- * Effect body result accepted by `ctx.effect()` and plugin startup.
- *
- * Either a single disposer, a promise of one, or a (possibly async) iterable
- * yielding several — generator effects register each yielded disposer as it
- * is produced.
- */
-type Effect<T = any> =
-  | SyncEffect<T>
-  | AsyncEffect<T>
-```
-
-[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L83)
-
-## Disposable
-
-Function returned by an effect to release resources during disposal.
-
-Disposers run in reverse registration order when the owning fiber unloads; they may be async, in which case unloading awaits them.
-
-```ts cordis-catalog
-/**
- * Function returned by an effect to release resources during disposal.
- *
- * Disposers run in reverse registration order when the owning fiber unloads;
- * they may be async, in which case unloading awaits them.
- */
-type Disposable<T = any> = () => T
-```
-
-[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L74)
-
-## EffectMeta
-
-Tree node used to expose nested effect labels for diagnostics.
-
-```ts cordis-catalog
-/** Tree node used to expose nested effect labels for diagnostics. */
-interface EffectMeta {
-  /** Human-readable effect label, e.g. `ctx.on("event")` or `ctx.provide("name")`. */
-  label: string
-  /** Metadata of nested effects registered while this effect ran. */
-  children: EffectMeta[]
-}
-```
-
-[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L96)
-
-## CordisError
-
-Framework error with a stable machine-readable code.
-
-```ts cordis-catalog
-/** Framework error with a stable machine-readable code. */
-class CordisError extends Error {
-  /**
-   * @param code — the stable error code; also the default message.
-   * @param message — optional human-readable override.
-   */
-  constructor(public code: CordisError.Code, message?: string)
-}
-
-/** Cordis error code definitions. */
-namespace CordisError {
-  export type Code = keyof typeof Code
-
-  export const Code = {
-    INACTIVE_EFFECT: 'cannot create effect on inactive context',
-  } as const
-}
-```
-
-[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L157)
-
-## ValidationError
-
-Error raised when plugin configuration fails standard-schema validation.
-
-```ts cordis-catalog
-/** Error raised when plugin configuration fails standard-schema validation. */
-class ValidationError extends TypeError {
-  name = 'ValidationError'
-
-  /**
-   * Build the aggregated message from schema issues.
-   *
-   * @param issues — the standard-schema issues, one message line each.
-   */
-  constructor(issues: readonly StandardSchemaV1.Issue[])
-}
-```
-
-[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L19)
+---
+editSource: "docs/cordis-api/fiber.md"
+rawMarkdownPath: "en/reference/cordis-api/fiber.md"
+---
+
+<!-- Generated by scripts/gen-cordis-catalog.ts — do not edit by hand.
+     Run `pnpm run gen-cordis-catalog` to regenerate. -->
+
+# Fiber
+
+A fiber is one loaded plugin instance: its lifecycle state, validated config, and registered effects. `ctx.fiber` is the current fiber, and `ctx.effect()` delegates to it.
+
+### ctx.effect(execute, label?)
+
+```ts cordis-catalog
+/**
+ * Register a cleanup-aware effect on this fiber.
+ *
+ * `execute` runs immediately; the disposers it produces are collected and
+ * run (in reverse order) either when the returned disposer is called or
+ * when the fiber unloads, whichever comes first. Calling the disposer twice
+ * is a no-op. Throws `CordisError('INACTIVE_EFFECT')` if the fiber is
+ * already disposed, and `TypeError` if `execute` returns an invalid shape.
+ *
+ * @param execute — the effect body; see {@link Effect} for accepted shapes.
+ * @param label — effect label shown in `getEffects()` diagnostics.
+ * @returns a disposer that tears the effect down and settles once done.
+ */
+effect(execute: () => SyncEffect, label?: string): Disposable<Promise<void>>
+effect(execute: () => Effect, label?: string): AsyncDisposable<Promise<void>>
+```
+
+Register a cleanup-aware effect on this fiber.
+
+`execute` runs immediately; the disposers it produces are collected and run (in reverse order) either when the returned disposer is called or when the fiber unloads, whichever comes first. Calling the disposer twice is a no-op. Throws `CordisError('INACTIVE_EFFECT')` if the fiber is already disposed, and `TypeError` if `execute` returns an invalid shape.
+
+- `execute` — the effect body; see `Effect` for accepted shapes.
+- `label` — effect label shown in `getEffects()` diagnostics.
+
+**Returns** a disposer that tears the effect down and settles once done.
+
+[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L443)
+
+### ctx.fiber
+
+```ts cordis-catalog
+/** The fiber (plugin runtime instance) that owns this context. */
+fiber: Fiber
+```
+
+The fiber (plugin runtime instance) that owns this context.
+
+[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L12)
+
+## The Fiber class
+
+Runtime instance of one plugin application.
+
+A fiber tracks dependency state, raw and effective config, lifecycle effects, and cleanup for the plugin context returned by `ctx.plugin()`.
+
+[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L214)
+
+### fiber.uid
+
+```ts cordis-catalog
+/** Unique id within the registry; 0 for the root fiber, `null` once disposed. */
+public uid: number | null
+```
+
+Unique id within the registry; 0 for the root fiber, `null` once disposed.
+
+[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L216)
+
+### fiber.ctx
+
+```ts cordis-catalog
+/** The context this fiber's plugin runs in (extends the parent context). */
+public readonly ctx: Context
+```
+
+The context this fiber's plugin runs in (extends the parent context).
+
+[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L218)
+
+### fiber.config
+
+```ts cordis-catalog
+/** Raw plugin input retained for the next activation. */
+public config: any
+```
+
+Raw plugin input retained for the next activation.
+
+[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L220)
+
+### fiber.state
+
+```ts cordis-catalog
+/** Current lifecycle state; transitions emit `internal/status`. */
+public state
+```
+
+Current lifecycle state; transitions emit `internal/status`.
+
+[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L222)
+
+### fiber.dispose
+
+```ts cordis-catalog
+/** Dispose this fiber: unload the plugin, then settle once cleanup finished. */
+public readonly dispose: () => Promise<void>
+```
+
+Dispose this fiber: unload the plugin, then settle once cleanup finished.
+
+[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L224)
+
+### fiber.committed
+
+```ts cordis-catalog
+/** Required implementations retained through dependent teardown. */
+public committed: Readonly<Dict<Impl>> | undefined
+```
+
+Required implementations retained through dependent teardown.
+
+[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L226)
+
+### fiber.provisions
+
+```ts cordis-catalog
+/** Service implementations owned by this fiber, including isolated provisions. */
+public readonly provisions: Set<Impl>
+```
+
+Service implementations owned by this fiber, including isolated provisions.
+
+[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L228)
+
+### fiber.inertia
+
+```ts cordis-catalog
+/** The in-flight load/unload transition, if one is currently running. */
+public inertia: Promise<void> | undefined
+```
+
+The in-flight load/unload transition, if one is currently running.
+
+[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L230)
+
+### fiber.name
+
+```ts cordis-catalog
+/** The plugin's display name, inherited from the nearest named ancestor, else `'root'`. */
+get name()
+```
+
+The plugin's display name, inherited from the nearest named ancestor, else `'root'`.
+
+[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L364)
+
+### fiber.assertActive()
+
+```ts cordis-catalog
+/**
+ * Throw if the fiber has already been disposed.
+ *
+ * @returns nothing when the fiber is still active.
+ * @throws {CordisError} `INACTIVE_EFFECT` when the fiber's uid has been cleared.
+ */
+assertActive()
+```
+
+Throw if the fiber has already been disposed.
+
+**Returns** nothing when the fiber is still active.
+
+[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L379)
+
+### fiber.effect(execute, label?)
+
+```ts cordis-catalog
+/**
+ * Register a cleanup-aware effect on this fiber.
+ *
+ * `execute` runs immediately; the disposers it produces are collected and
+ * run (in reverse order) either when the returned disposer is called or
+ * when the fiber unloads, whichever comes first. Calling the disposer twice
+ * is a no-op. Throws `CordisError('INACTIVE_EFFECT')` if the fiber is
+ * already disposed, and `TypeError` if `execute` returns an invalid shape.
+ *
+ * @param execute — the effect body; see {@link Effect} for accepted shapes.
+ * @param label — effect label shown in `getEffects()` diagnostics.
+ * @returns a disposer that tears the effect down and settles once done.
+ */
+effect(execute: () => SyncEffect, label?: string): Disposable<Promise<void>>
+effect(execute: () => Effect, label?: string): AsyncDisposable<Promise<void>>
+```
+
+Register a cleanup-aware effect on this fiber.
+
+`execute` runs immediately; the disposers it produces are collected and run (in reverse order) either when the returned disposer is called or when the fiber unloads, whichever comes first. Calling the disposer twice is a no-op. Throws `CordisError('INACTIVE_EFFECT')` if the fiber is already disposed, and `TypeError` if `execute` returns an invalid shape.
+
+- `execute` — the effect body; see `Effect` for accepted shapes.
+- `label` — effect label shown in `getEffects()` diagnostics.
+
+**Returns** a disposer that tears the effect down and settles once done.
+
+[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L443)
+
+### fiber.getEffects()
+
+```ts cordis-catalog
+/**
+ * Return metadata for currently registered effects.
+ *
+ * @returns one {@link EffectMeta} tree per labeled live effect.
+ */
+getEffects()
+```
+
+Return metadata for currently registered effects.
+
+**Returns** one `EffectMeta` tree per labeled live effect.
+
+[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L596)
+
+### fiber.rawConfig
+
+```ts cordis-catalog
+/** Raw input retained for the next activation, without evaluating expressions or validating it. */
+get rawConfig(): unknown
+```
+
+Raw input retained for the next activation, without evaluating expressions or validating it.
+
+[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L671)
+
+### fiber.effectiveConfig
+
+```ts cordis-catalog
+/**
+ * The object passed to plugin activation or the latest successful update that retained the instance.
+ * Candidate resolution does not publish it; volatile updates retain its references.
+ * Undefined before activation and readable after unload; callers requiring a live instance check `state`.
+ */
+get effectiveConfig(): unknown
+```
+
+The object passed to plugin activation or the latest successful update that retained the instance. Candidate resolution does not publish it; volatile updates retain its references. Undefined before activation and readable after unload; callers requiring a live instance check `state`.
+
+[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L686)
+
+### fiber.resolveConfig(config)
+
+```ts cordis-catalog
+/**
+ * Evaluate and validate a candidate using this fiber's `internal/config` hooks and runtime schema.
+ * Does not publish the result, replace raw input, or commit running volatile references.
+ * Required injections must be available when a hook uses them.
+ * @param config Raw candidate input.
+ * @returns The candidate's resolved config, retaining the schema's result identity.
+ * @throws {ValidationError} when the runtime schema rejects the candidate; hook errors propagate.
+ */
+resolveConfig(config: unknown): unknown
+```
+
+Evaluate and validate a candidate using this fiber's `internal/config` hooks and runtime schema. Does not publish the result, replace raw input, or commit running volatile references. Required injections must be available when a hook uses them.
+
+- `config` — Raw candidate input.
+
+**Returns** The candidate's resolved config, retaining the schema's result identity.
+
+[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L698)
+
+### fiber.await()
+
+```ts cordis-catalog
+/**
+ * Wait for current lifecycle work and rethrow startup errors.
+ *
+ * @returns this fiber, once it has settled into a stable state.
+ * @throws the config-validation or plugin-startup error, if any.
+ */
+async await()
+```
+
+Wait for current lifecycle work and rethrow startup errors.
+
+**Returns** this fiber, once it has settled into a stable state.
+
+[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L776)
+
+### fiber.restart()
+
+```ts cordis-catalog
+/**
+ * Dispose and immediately reload this plugin with its current config.
+ *
+ * @returns a promise resolving once the reload settled.
+ * @throws {CordisError} `INACTIVE_EFFECT` when the fiber is already disposed.
+ */
+async restart()
+```
+
+Dispose and immediately reload this plugin with its current config.
+
+**Returns** a promise resolving once the reload settled.
+
+[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L790)
+
+### fiber.update(config, noSave?)
+
+```ts cordis-catalog
+/**
+ * Resolve a candidate, retain its raw config and apply it through the update waterfall.
+ * @param config Raw config; pending fibers defer resolution until activation.
+ * @param noSave Suppress the persistence notification when true.
+ * @returns The awaited update/restart result, or undefined when a synchronous listener handles it.
+ * @throws {ValidationError} when an active fiber's candidate is invalid.
+ */
+update(config: any, noSave = false): Awaitable<void>
+```
+
+Resolve a candidate, retain its raw config and apply it through the update waterfall.
+
+- `config` — Raw config; pending fibers defer resolution until activation.
+- `noSave` — Suppress the persistence notification when true.
+
+**Returns** The awaited update/restart result, or undefined when a synchronous listener handles it.
+
+[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L805)
+
+## Effect
+
+Effect body result accepted by `ctx.effect()` and plugin startup.
+
+Either a single disposer, a promise of one, or a (possibly async) iterable yielding several — generator effects register each yielded disposer as it is produced.
+
+```ts cordis-catalog
+/**
+ * Effect body result accepted by `ctx.effect()` and plugin startup.
+ *
+ * Either a single disposer, a promise of one, or a (possibly async) iterable
+ * yielding several — generator effects register each yielded disposer as it
+ * is produced.
+ */
+type Effect<T = any> =
+  | SyncEffect<T>
+  | AsyncEffect<T>
+```
+
+[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L113)
+
+## Disposable
+
+Function returned by an effect to release resources during disposal.
+
+Disposers run in reverse registration order when the owning fiber unloads; they may be async, in which case unloading awaits them.
+
+```ts cordis-catalog
+/**
+ * Function returned by an effect to release resources during disposal.
+ *
+ * Disposers run in reverse registration order when the owning fiber unloads;
+ * they may be async, in which case unloading awaits them.
+ */
+type Disposable<T = any> = () => T
+```
+
+[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L104)
+
+## EffectMeta
+
+Tree node used to expose nested effect labels for diagnostics.
+
+```ts cordis-catalog
+/** Tree node used to expose nested effect labels for diagnostics. */
+interface EffectMeta {
+  /** Human-readable effect label, e.g. `ctx.on("event")` or `ctx.provide("name")`. */
+  label: string
+  /** Metadata of nested effects registered while this effect ran. */
+  children: EffectMeta[]
+}
+```
+
+[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L126)
+
+## CordisError
+
+Framework error with a stable machine-readable code.
+
+```ts cordis-catalog
+/** Framework error with a stable machine-readable code. */
+class CordisError extends Error {
+  /**
+   * @param code — the stable error code; also the default message.
+   * @param message — optional human-readable override.
+   */
+  constructor(public code: CordisError.Code, message?: string)
+}
+
+/** Cordis error code definitions. */
+namespace CordisError {
+  export type Code = keyof typeof Code
+
+  export const Code = {
+    INACTIVE_EFFECT: 'cannot create effect on inactive context',
+  } as const
+}
+```
+
+[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L187)
+
+## ValidationError
+
+Error raised when plugin configuration fails standard-schema validation.
+
+```ts cordis-catalog
+/** Error raised when plugin configuration fails standard-schema validation. */
+class ValidationError extends TypeError {
+  name = 'ValidationError'
+
+  /**
+   * Build the aggregated message from schema issues.
+   *
+   * @param issues — the standard-schema issues, one message line each.
+   */
+  constructor(public issues: readonly StandardSchemaV1.Issue[])
+
+  /**
+   * Test whether a value is a config `ValidationError`, including one from another copy of Cordis.
+   *
+   * @param error — the value to test.
+   * @returns `true` if `error` carries the global validation-error brand.
+   */
+  static is(error: unknown): error is ValidationError
+
+  /**
+   * Convert an issue path to plain property keys.
+   *
+   * @param path — the standard-schema issue path; segments may be `{ key }` objects.
+   * @returns the property keys, or an empty array when the issue has no path.
+   */
+  static normalizePath(path: StandardSchemaV1.Issue['path'] = [])
+
+  /**
+   * Format an issue path as a dotted string.
+   *
+   * @param path — the standard-schema issue path.
+   * @returns the keys joined with `.`.
+   */
+  static formatPath(path: StandardSchemaV1.Issue['path'])
+}
+```
+
+[Source](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/src/fiber.ts#L19)