@zhin.js/prompt-section 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 凉菜
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,9 @@
+# @zhin.js/prompt-section
+
+Generation-owned Agent Prompt Section Feature。插件根目录的
+`agent/prompt-sections/**/*.ts` 默认导出 `defineAgentPromptSection(...)`，并作为
+immutable capability slot 进入当前 generation。
+
+Prompt Section 只贡献模型上下文，不授予 Tool、文件、网络、审批或 Workroom 权限。
+`PromptSectionIndex.visible(owner, profile)` 按 Plugin owner 继承链解析，并固定到当前
+generation；HMR 原子发布新 projection，在途 Turn 继续使用旧 snapshot。

package/lib/definition.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Prompt Section authoring API consumed from `@zhin.js/prompt-section`.
+ * @module @zhin.js/prompt-section
+ */
+declare const promptSectionBrand: "zhin.agent-prompt-section/1";
+export type PromptSectionLayer = 'system' | 'role' | 'task' | 'context' | 'tools' | 'safety' | 'constraints' | 'examples' | 'memory';
+export type PromptSectionRetention = 'required' | 'preferred' | 'opportunistic';
+export type PromptProfile = 'interactive' | 'schedule';
+export interface AgentPromptSectionDefinition {
+    /** @internal Runtime feature brand. */
+    readonly $feature: typeof promptSectionBrand;
+    readonly title: string;
+    readonly content: string;
+    readonly layer: PromptSectionLayer;
+    readonly order: number;
+    readonly retention: PromptSectionRetention;
+    readonly maxChars?: number;
+    readonly profiles: readonly PromptProfile[];
+    readonly platforms?: readonly string[];
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+export type AgentPromptSectionInput = Omit<AgentPromptSectionDefinition, '$feature' | 'layer' | 'order' | 'retention' | 'profiles'> & Partial<Pick<AgentPromptSectionDefinition, 'layer' | 'order' | 'retention' | 'profiles'>>;
+declare module '@zhin.js/plugin-runtime' {
+    interface PluginSetupContext<TConfig = unknown> {
+        addPromptSection(localName: string, definition: AgentPromptSectionDefinition): void;
+    }
+}
+/**
+ * Define a generation-owned Prompt section with deterministic layer and budget policy.
+ * Required sections fail closed when they cannot fit the active Prompt budget.
+ *
+ * @public
+ * @experimental
+ */
+export declare function defineAgentPromptSection(input: AgentPromptSectionInput): Readonly<AgentPromptSectionDefinition>;
+/** @internal Runtime validation for convention-discovered modules. */
+export declare function parseAgentPromptSectionDefinition(value: unknown): AgentPromptSectionDefinition;
+export {};

package/lib/definition.js

@@ -0,0 +1,107 @@
+/**
+ * Prompt Section authoring API consumed from `@zhin.js/prompt-section`.
+ * @module @zhin.js/prompt-section
+ */
+const promptSectionBrand = 'zhin.agent-prompt-section/1';
+/**
+ * Define a generation-owned Prompt section with deterministic layer and budget policy.
+ * Required sections fail closed when they cannot fit the active Prompt budget.
+ *
+ * @public
+ * @experimental
+ */
+export function defineAgentPromptSection(input) {
+    if (!input.title?.trim())
+        throw new TypeError('Prompt Section title cannot be empty');
+    if (!input.content?.trim())
+        throw new TypeError('Prompt Section content cannot be empty');
+    const layer = input.layer ?? 'context';
+    if (!LAYERS.has(layer))
+        throw new TypeError(`Invalid Prompt Section layer: ${String(layer)}`);
+    const order = input.order ?? 50;
+    if (!Number.isSafeInteger(order))
+        throw new TypeError('Prompt Section order must be a safe integer');
+    const retention = input.retention ?? 'preferred';
+    if (!RETENTIONS.has(retention)) {
+        throw new TypeError(`Invalid Prompt Section retention: ${String(retention)}`);
+    }
+    if (input.maxChars !== undefined && (!Number.isSafeInteger(input.maxChars) || input.maxChars <= 0)) {
+        throw new TypeError('Prompt Section maxChars must be a positive safe integer');
+    }
+    const profiles = input.profiles ?? ['interactive'];
+    if (!Array.isArray(profiles) || profiles.length === 0 || profiles.some((profile) => !PROFILES.has(profile))) {
+        throw new TypeError('Prompt Section profiles must contain interactive or schedule');
+    }
+    if (new Set(profiles).size !== profiles.length) {
+        throw new TypeError('Prompt Section profiles cannot contain duplicates');
+    }
+    const platforms = input.platforms?.map((platform) => platform.trim());
+    if (platforms && (platforms.length === 0
+        || platforms.some((platform) => !platform)
+        || new Set(platforms).size !== platforms.length)) {
+        throw new TypeError('Prompt Section platforms must contain unique non-empty names');
+    }
+    if (input.metadata !== undefined
+        && (!input.metadata || typeof input.metadata !== 'object' || Array.isArray(input.metadata))) {
+        throw new TypeError('Prompt Section metadata must be an object');
+    }
+    return Object.freeze({
+        ...input,
+        $feature: promptSectionBrand,
+        title: input.title.trim(),
+        content: input.content.trim(),
+        layer,
+        order,
+        retention,
+        profiles: Object.freeze([...profiles]),
+        ...(platforms ? { platforms: Object.freeze(platforms) } : {}),
+        ...(input.metadata ? { metadata: Object.freeze({ ...input.metadata }) } : {}),
+    });
+}
+/** @internal Runtime validation for convention-discovered modules. */
+export function parseAgentPromptSectionDefinition(value) {
+    if (!value || typeof value !== 'object')
+        throw invalidPromptSection();
+    const definition = value;
+    if (definition.$feature !== promptSectionBrand
+        || typeof definition.title !== 'string'
+        || !definition.title.trim()
+        || typeof definition.content !== 'string'
+        || !definition.content.trim()
+        || !LAYERS.has(definition.layer)
+        || !Number.isSafeInteger(definition.order)
+        || !RETENTIONS.has(definition.retention)
+        || (definition.maxChars !== undefined
+            && (!Number.isSafeInteger(definition.maxChars) || definition.maxChars <= 0))
+        || !Array.isArray(definition.profiles)
+        || definition.profiles.length === 0
+        || definition.profiles.some((profile) => !PROFILES.has(profile))
+        || new Set(definition.profiles).size !== definition.profiles.length
+        || (definition.platforms !== undefined
+            && (!Array.isArray(definition.platforms)
+                || definition.platforms.length === 0
+                || definition.platforms.some((platform) => typeof platform !== 'string' || !platform.trim())
+                || new Set(definition.platforms).size !== definition.platforms.length))
+        || (definition.metadata !== undefined
+            && (!definition.metadata || typeof definition.metadata !== 'object' || Array.isArray(definition.metadata))))
+        throw invalidPromptSection();
+    return defineAgentPromptSection({
+        title: definition.title,
+        content: definition.content,
+        layer: definition.layer,
+        order: definition.order,
+        retention: definition.retention,
+        maxChars: definition.maxChars,
+        profiles: definition.profiles,
+        platforms: definition.platforms,
+        metadata: definition.metadata,
+    });
+}
+const LAYERS = new Set([
+    'system', 'role', 'task', 'context', 'tools', 'safety', 'constraints', 'examples', 'memory',
+]);
+const RETENTIONS = new Set(['required', 'preferred', 'opportunistic']);
+const PROFILES = new Set(['interactive', 'schedule']);
+function invalidPromptSection() {
+    return new TypeError('Prompt Section module must default-export defineAgentPromptSection(...)');
+}

package/lib/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Generation-owned Agent Prompt Section authoring contracts.
+ * @module @zhin.js/prompt-section
+ */
+/** @public Prompt Section authoring contract and `defineAgentPromptSection`. */
+export * from './definition.js';
+/** @internal Runtime Prompt Section projection. */
+export * from './prompt-section-index.js';
+/** @internal Feature provider installed by the Runtime composition root. */
+export * from './provider.js';
+export { default } from './provider.js';

package/lib/index.js

@@ -0,0 +1,11 @@
+/**
+ * Generation-owned Agent Prompt Section authoring contracts.
+ * @module @zhin.js/prompt-section
+ */
+/** @public Prompt Section authoring contract and `defineAgentPromptSection`. */
+export * from './definition.js';
+/** @internal Runtime Prompt Section projection. */
+export * from './prompt-section-index.js';
+/** @internal Feature provider installed by the Runtime composition root. */
+export * from './provider.js';
+export { default } from './provider.js';

package/lib/prompt-section-index.d.ts

@@ -0,0 +1,18 @@
+import type { CapabilitySlot, PluginId, RuntimeSnapshot } from '@zhin.js/plugin-runtime';
+import type { AgentPromptSectionDefinition, PromptProfile } from './definition.js';
+export interface PromptSectionDescriptor extends AgentPromptSectionDefinition {
+    readonly owner: PluginId;
+    readonly name: string;
+    readonly qualifiedName: string;
+    readonly source: string;
+    readonly generation: number;
+}
+export declare class PromptSectionIndex {
+    #private;
+    private readonly snapshot;
+    readonly $projection: "zhin.prompt-section-index/1";
+    constructor(slots: readonly Readonly<CapabilitySlot<AgentPromptSectionDefinition>>[], snapshot: RuntimeSnapshot);
+    list(): readonly PromptSectionDescriptor[];
+    visible(requester: PluginId, profile: PromptProfile): readonly PromptSectionDescriptor[];
+}
+export declare function isPromptSectionIndex(value: unknown): value is PromptSectionIndex;

package/lib/prompt-section-index.js

@@ -0,0 +1,32 @@
+import { OwnerCapabilityIndex, } from '@zhin.js/feature-kit';
+export class PromptSectionIndex {
+    snapshot;
+    $projection = 'zhin.prompt-section-index/1';
+    #index;
+    constructor(slots, snapshot) {
+        this.snapshot = snapshot;
+        this.#index = new OwnerCapabilityIndex(slots, snapshot);
+    }
+    list() {
+        return this.#index.entries().map((entry) => toDescriptor(entry, this.snapshot.generation));
+    }
+    visible(requester, profile) {
+        return Object.freeze(this.#index.visible(requester)
+            .filter((entry) => entry.slot.definition.profiles.includes(profile))
+            .map((entry) => toDescriptor(entry, this.snapshot.generation)));
+    }
+}
+export function isPromptSectionIndex(value) {
+    return !!value && typeof value === 'object'
+        && value.$projection === 'zhin.prompt-section-index/1';
+}
+function toDescriptor(entry, generation) {
+    return Object.freeze({
+        ...entry.slot.definition,
+        owner: entry.owner,
+        name: entry.name,
+        qualifiedName: entry.qualifiedName,
+        source: entry.source,
+        generation,
+    });
+}

package/lib/provider.d.ts

@@ -0,0 +1,5 @@
+import { PromptSectionIndex } from './prompt-section-index.js';
+export declare const promptSectionFeatureId: import("@zhin.js/plugin-runtime").FeatureId;
+declare const promptSectionFeature: Readonly<import("@zhin.js/feature-kit").FeatureProvider<import("./definition.js").AgentPromptSectionDefinition, PromptSectionIndex>>;
+export { promptSectionFeature };
+export default promptSectionFeature;

package/lib/provider.js

@@ -0,0 +1,25 @@
+import { featureId } from '@zhin.js/plugin-runtime';
+import { defineFeatureProvider, typeScriptModules } from '@zhin.js/feature-kit';
+import { parseAgentPromptSectionDefinition } from './definition.js';
+import { PromptSectionIndex } from './prompt-section-index.js';
+export const promptSectionFeatureId = featureId('zhin.agent-prompt-section');
+const promptSectionFeature = defineFeatureProvider({
+    protocol: 1,
+    id: promptSectionFeatureId,
+    authoring: {
+        setupMethod: 'addPromptSection',
+        conventions: [typeScriptModules({
+                id: 'agent-prompt-sections-ts',
+                directory: 'agent/prompt-sections',
+                recursive: true,
+            })],
+        validate: parseAgentPromptSectionDefinition,
+    },
+    runtime: {
+        project(slots, context) {
+            return { value: new PromptSectionIndex(slots, context.snapshot) };
+        },
+    },
+});
+export { promptSectionFeature };
+export default promptSectionFeature;

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@zhin.js/prompt-section",
+  "version": "0.0.0",
+  "description": "Generation-owned Agent Prompt Section Feature for Zhin Plugin Runtime",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "development": "./src/index.ts",
+      "import": "./lib/index.js"
+    }
+  },
+  "files": [
+    "lib",
+    "src"
+  ],
+  "dependencies": {
+    "@zhin.js/feature-kit": "1.0.12",
+    "@zhin.js/plugin-runtime": "1.1.7"
+  },
+  "devDependencies": {
+    "@types/node": "^26.1.2",
+    "typescript": "^6.0.3"
+  },
+  "zhin": {
+    "protocol": 1,
+    "type": "feature",
+    "entry": "./lib/provider.js",
+    "engine": "^1.0.0",
+    "featureApi": "1.0.0"
+  },
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "license": "MIT",
+  "private": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zhinjs/zhin.git",
+    "directory": "packages/im/prompt-section"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rimraf lib",
+    "test": "vitest run --root ../../.. packages/im/prompt-section/tests"
+  }
+}

package/src/definition.ts

@@ -0,0 +1,153 @@
+/**
+ * Prompt Section authoring API consumed from `@zhin.js/prompt-section`.
+ * @module @zhin.js/prompt-section
+ */
+const promptSectionBrand = 'zhin.agent-prompt-section/1' as const;
+
+export type PromptSectionLayer =
+  | 'system'
+  | 'role'
+  | 'task'
+  | 'context'
+  | 'tools'
+  | 'safety'
+  | 'constraints'
+  | 'examples'
+  | 'memory';
+
+export type PromptSectionRetention = 'required' | 'preferred' | 'opportunistic';
+export type PromptProfile = 'interactive' | 'schedule';
+
+export interface AgentPromptSectionDefinition {
+  /** @internal Runtime feature brand. */
+  readonly $feature: typeof promptSectionBrand;
+  readonly title: string;
+  readonly content: string;
+  readonly layer: PromptSectionLayer;
+  readonly order: number;
+  readonly retention: PromptSectionRetention;
+  readonly maxChars?: number;
+  readonly profiles: readonly PromptProfile[];
+  readonly platforms?: readonly string[];
+  readonly metadata?: Readonly<Record<string, unknown>>;
+}
+
+export type AgentPromptSectionInput = Omit<
+  AgentPromptSectionDefinition,
+  '$feature' | 'layer' | 'order' | 'retention' | 'profiles'
+> & Partial<Pick<
+  AgentPromptSectionDefinition,
+  'layer' | 'order' | 'retention' | 'profiles'
+>>;
+
+declare module '@zhin.js/plugin-runtime' {
+  // Type parameter name must match the base PluginSetupContext declaration (TS2428).
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
+  interface PluginSetupContext<TConfig = unknown> {
+    addPromptSection(localName: string, definition: AgentPromptSectionDefinition): void;
+  }
+}
+
+/**
+ * Define a generation-owned Prompt section with deterministic layer and budget policy.
+ * Required sections fail closed when they cannot fit the active Prompt budget.
+ *
+ * @public
+ * @experimental
+ */
+export function defineAgentPromptSection(
+  input: AgentPromptSectionInput,
+): Readonly<AgentPromptSectionDefinition> {
+  if (!input.title?.trim()) throw new TypeError('Prompt Section title cannot be empty');
+  if (!input.content?.trim()) throw new TypeError('Prompt Section content cannot be empty');
+  const layer = input.layer ?? 'context';
+  if (!LAYERS.has(layer)) throw new TypeError(`Invalid Prompt Section layer: ${String(layer)}`);
+  const order = input.order ?? 50;
+  if (!Number.isSafeInteger(order)) throw new TypeError('Prompt Section order must be a safe integer');
+  const retention = input.retention ?? 'preferred';
+  if (!RETENTIONS.has(retention)) {
+    throw new TypeError(`Invalid Prompt Section retention: ${String(retention)}`);
+  }
+  if (input.maxChars !== undefined && (!Number.isSafeInteger(input.maxChars) || input.maxChars <= 0)) {
+    throw new TypeError('Prompt Section maxChars must be a positive safe integer');
+  }
+  const profiles = input.profiles ?? ['interactive'];
+  if (!Array.isArray(profiles) || profiles.length === 0 || profiles.some((profile) => !PROFILES.has(profile))) {
+    throw new TypeError('Prompt Section profiles must contain interactive or schedule');
+  }
+  if (new Set(profiles).size !== profiles.length) {
+    throw new TypeError('Prompt Section profiles cannot contain duplicates');
+  }
+  const platforms = input.platforms?.map((platform) => platform.trim());
+  if (platforms && (platforms.length === 0
+    || platforms.some((platform) => !platform)
+    || new Set(platforms).size !== platforms.length)) {
+    throw new TypeError('Prompt Section platforms must contain unique non-empty names');
+  }
+  if (input.metadata !== undefined
+    && (!input.metadata || typeof input.metadata !== 'object' || Array.isArray(input.metadata))) {
+    throw new TypeError('Prompt Section metadata must be an object');
+  }
+  return Object.freeze({
+    ...input,
+    $feature: promptSectionBrand,
+    title: input.title.trim(),
+    content: input.content.trim(),
+    layer,
+    order,
+    retention,
+    profiles: Object.freeze([...profiles]),
+    ...(platforms ? { platforms: Object.freeze(platforms) } : {}),
+    ...(input.metadata ? { metadata: Object.freeze({ ...input.metadata }) } : {}),
+  });
+}
+
+/** @internal Runtime validation for convention-discovered modules. */
+export function parseAgentPromptSectionDefinition(value: unknown): AgentPromptSectionDefinition {
+  if (!value || typeof value !== 'object') throw invalidPromptSection();
+  const definition = value as Partial<AgentPromptSectionDefinition>;
+  if (
+    definition.$feature !== promptSectionBrand
+    || typeof definition.title !== 'string'
+    || !definition.title.trim()
+    || typeof definition.content !== 'string'
+    || !definition.content.trim()
+    || !LAYERS.has(definition.layer as PromptSectionLayer)
+    || !Number.isSafeInteger(definition.order)
+    || !RETENTIONS.has(definition.retention as PromptSectionRetention)
+    || (definition.maxChars !== undefined
+      && (!Number.isSafeInteger(definition.maxChars) || definition.maxChars <= 0))
+    || !Array.isArray(definition.profiles)
+    || definition.profiles.length === 0
+    || definition.profiles.some((profile) => !PROFILES.has(profile))
+    || new Set(definition.profiles).size !== definition.profiles.length
+    || (definition.platforms !== undefined
+      && (!Array.isArray(definition.platforms)
+        || definition.platforms.length === 0
+        || definition.platforms.some((platform) => typeof platform !== 'string' || !platform.trim())
+        || new Set(definition.platforms).size !== definition.platforms.length))
+    || (definition.metadata !== undefined
+      && (!definition.metadata || typeof definition.metadata !== 'object' || Array.isArray(definition.metadata)))
+  ) throw invalidPromptSection();
+  return defineAgentPromptSection({
+    title: definition.title,
+    content: definition.content,
+    layer: definition.layer,
+    order: definition.order,
+    retention: definition.retention,
+    maxChars: definition.maxChars,
+    profiles: definition.profiles,
+    platforms: definition.platforms,
+    metadata: definition.metadata,
+  });
+}
+
+const LAYERS = new Set<PromptSectionLayer>([
+  'system', 'role', 'task', 'context', 'tools', 'safety', 'constraints', 'examples', 'memory',
+]);
+const RETENTIONS = new Set<PromptSectionRetention>(['required', 'preferred', 'opportunistic']);
+const PROFILES = new Set<PromptProfile>(['interactive', 'schedule']);
+
+function invalidPromptSection(): TypeError {
+  return new TypeError('Prompt Section module must default-export defineAgentPromptSection(...)');
+}

package/src/index.ts

@@ -0,0 +1,11 @@
+/**
+ * Generation-owned Agent Prompt Section authoring contracts.
+ * @module @zhin.js/prompt-section
+ */
+/** @public Prompt Section authoring contract and `defineAgentPromptSection`. */
+export * from './definition.js';
+/** @internal Runtime Prompt Section projection. */
+export * from './prompt-section-index.js';
+/** @internal Feature provider installed by the Runtime composition root. */
+export * from './provider.js';
+export { default } from './provider.js';

package/src/prompt-section-index.ts

@@ -0,0 +1,58 @@
+import type { CapabilitySlot, PluginId, RuntimeSnapshot } from '@zhin.js/plugin-runtime';
+import {
+  OwnerCapabilityIndex,
+  type OwnerCapabilityEntry,
+} from '@zhin.js/feature-kit';
+import type {
+  AgentPromptSectionDefinition,
+  PromptProfile,
+} from './definition.js';
+
+export interface PromptSectionDescriptor extends AgentPromptSectionDefinition {
+  readonly owner: PluginId;
+  readonly name: string;
+  readonly qualifiedName: string;
+  readonly source: string;
+  readonly generation: number;
+}
+
+export class PromptSectionIndex {
+  readonly $projection = 'zhin.prompt-section-index/1' as const;
+  readonly #index: OwnerCapabilityIndex<AgentPromptSectionDefinition>;
+
+  constructor(
+    slots: readonly Readonly<CapabilitySlot<AgentPromptSectionDefinition>>[],
+    private readonly snapshot: RuntimeSnapshot,
+  ) {
+    this.#index = new OwnerCapabilityIndex(slots, snapshot);
+  }
+
+  list(): readonly PromptSectionDescriptor[] {
+    return this.#index.entries().map((entry) => toDescriptor(entry, this.snapshot.generation));
+  }
+
+  visible(requester: PluginId, profile: PromptProfile): readonly PromptSectionDescriptor[] {
+    return Object.freeze(this.#index.visible(requester)
+      .filter((entry) => entry.slot.definition.profiles.includes(profile))
+      .map((entry) => toDescriptor(entry, this.snapshot.generation)));
+  }
+}
+
+export function isPromptSectionIndex(value: unknown): value is PromptSectionIndex {
+  return !!value && typeof value === 'object'
+    && (value as { readonly $projection?: unknown }).$projection === 'zhin.prompt-section-index/1';
+}
+
+function toDescriptor(
+  entry: OwnerCapabilityEntry<AgentPromptSectionDefinition>,
+  generation: number,
+): PromptSectionDescriptor {
+  return Object.freeze({
+    ...entry.slot.definition,
+    owner: entry.owner,
+    name: entry.name,
+    qualifiedName: entry.qualifiedName,
+    source: entry.source,
+    generation,
+  });
+}

package/src/provider.ts

@@ -0,0 +1,28 @@
+import { featureId } from '@zhin.js/plugin-runtime';
+import { defineFeatureProvider, typeScriptModules } from '@zhin.js/feature-kit';
+import { parseAgentPromptSectionDefinition } from './definition.js';
+import { PromptSectionIndex } from './prompt-section-index.js';
+
+export const promptSectionFeatureId = featureId('zhin.agent-prompt-section');
+
+const promptSectionFeature = defineFeatureProvider({
+  protocol: 1,
+  id: promptSectionFeatureId,
+  authoring: {
+    setupMethod: 'addPromptSection',
+    conventions: [typeScriptModules({
+      id: 'agent-prompt-sections-ts',
+      directory: 'agent/prompt-sections',
+      recursive: true,
+    })],
+    validate: parseAgentPromptSectionDefinition,
+  },
+  runtime: {
+    project(slots, context) {
+      return { value: new PromptSectionIndex(slots, context.snapshot) };
+    },
+  },
+});
+
+export { promptSectionFeature };
+export default promptSectionFeature;