@minion-stack/shared 0.4.0 → 0.5.0

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export * from './gateway/index.js';
 export * from './utils/index.js';
+export * from './prompt-sections.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -1,3 +1,4 @@
 export * from './gateway/index.js';
 export * from './utils/index.js';
+export * from './prompt-sections.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC"}

package/dist/prompt-sections.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Prompt Sections protocol types.
+ *
+ * Source of truth for `prompt.sections.*` WS gateway RPC request/response shapes.
+ * Consumed by the minion gateway server handlers and by `minion_hub` / `minion_site`
+ * UI that drives the prompt engineering surface.
+ *
+ * Pure protocol types only — runtime validation (Zod) stays in `minion/` where the
+ * gateway handlers live. Keep this file import-free so both Node and browser bundles
+ * can consume it without pulling in server-only dependencies.
+ *
+ * Extracted from `minion/src/agents/sections/custom/types.ts` +
+ * `minion/src/gateway/server-methods/prompt-sections.ts` in Phase 20-01.
+ */
+/** Assembly layer a section belongs to. Determines ordering + caching strategy. */
+export type SectionLayer = "platform" | "agent-type" | "identity" | "user" | "session";
+/** Prompt assembly mode. Sections declare which modes include them. */
+export type PromptMode = "full" | "minimal" | "none";
+/** Whether a section is code-defined (`builtin`) or operator-authored YAML (`custom`). */
+export type SectionSource = "builtin" | "custom";
+/**
+ * Input shape for `prompt.sections.upsert` and the custom-section YAML schema.
+ * `enabled` is optional on input (defaults to `true` server-side) so pre-0.5.0
+ * YAML files that omit the field continue to load unchanged.
+ */
+export interface SectionInput {
+    id: string;
+    layer: SectionLayer;
+    order: number;
+    modes: PromptMode[];
+    cacheable: boolean;
+    /** Introduced in @minion-stack/shared 0.5.0. Defaults to `true` when omitted. */
+    enabled?: boolean;
+    /** YAML body / rendered template string. */
+    render: string;
+}
+/**
+ * Metadata for `prompt.sections.list` rows. Lacks the rendered body — callers
+ * fetch that separately with `prompt.sections.get` to keep list responses small.
+ */
+export interface SectionMeta {
+    id: string;
+    layer: SectionLayer;
+    order: number;
+    modes: PromptMode[];
+    cacheable: boolean;
+    /** Introduced in @minion-stack/shared 0.5.0. Always present on responses. */
+    enabled: boolean;
+    source: SectionSource;
+    agentId?: string;
+}
+/** Full section shape for `prompt.sections.get`. Adds the rendered body. */
+export interface SectionFull extends SectionMeta {
+    render: string;
+}
+/** Per-section entry in the preview breakdown. */
+export interface SectionBreakdown {
+    id: string;
+    layer: SectionLayer;
+    order: number;
+    bytes: number;
+    tokens: number;
+    cacheable: boolean;
+    source: SectionSource;
+    rendered: string;
+}
+/** A single violation raised by the content safety scanner during upsert/preview. */
+export interface SectionViolation {
+    rule: string;
+    match?: string;
+    severity: "block" | "warn";
+}
+/** Structured payload attached to `SECTION_VALIDATION_FAILED` errors. */
+export interface SectionValidationErrorPayload {
+    code: "SECTION_VALIDATION_FAILED";
+    message: string;
+    violations: SectionViolation[];
+}
+/** Response shape for `prompt.sections.preview`. */
+export interface PreviewResponse {
+    assembled: string;
+    breakdown: SectionBreakdown[];
+    totalBytes: number;
+    totalTokens: number;
+    tokenizer: string;
+}
+/** Request params for `prompt.sections.list`. */
+export interface ListParams {
+    agentId: string;
+}
+/** Request params for `prompt.sections.get`. */
+export interface GetParams {
+    agentId: string;
+    sectionId: string;
+}
+/** Request params for `prompt.sections.upsert`. */
+export interface UpsertParams {
+    agentId: string;
+    section: SectionInput;
+}
+/** Request params for `prompt.sections.delete`. */
+export interface DeleteParams {
+    agentId: string;
+    sectionId: string;
+}
+/**
+ * Request params for `prompt.sections.preview`.
+ *
+ * Extended in @minion-stack/shared 0.5.0 with `draftOverride`. When present,
+ * the server substitutes the given body for the section whose id matches
+ * during in-memory assembly (on-disk YAML is NEVER modified). Use this to
+ * drive live preview of unsaved editor state in the hub.
+ *
+ * If `draftOverride.id` doesn't match any visible section (e.g. the operator
+ * just toggled it off), the server ignores it silently.
+ */
+export interface PreviewParams {
+    agentId: string;
+    mode: PromptMode;
+    draftOverride?: {
+        id: string;
+        body: string;
+    };
+}
+/** Request params for `prompt.sections.overrides.get`. New in 0.5.0. */
+export interface OverridesGetParams {
+    agentId: string;
+}
+/** Response shape for `prompt.sections.overrides.get`. New in 0.5.0. */
+export interface OverridesGetResponse {
+    disabled: string[];
+}
+/**
+ * Request params for `prompt.sections.overrides.set`. New in 0.5.0.
+ * `disabled` is the complete replacement list (not a delta). Admin-only.
+ * Server caps list length at 256 entries (T-20-04).
+ */
+export interface OverridesSetParams {
+    agentId: string;
+    disabled: string[];
+}
+/** Response shape for `prompt.sections.overrides.set`. New in 0.5.0. */
+export interface OverridesSetResponse {
+    disabled: string[];
+}
+//# sourceMappingURL=prompt-sections.d.ts.map

package/dist/prompt-sections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-sections.d.ts","sourceRoot":"","sources":["../src/prompt-sections.ts"],"names":[],"mappings":"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"}

package/dist/prompt-sections.js

@@ -0,0 +1,16 @@
+/**
+ * Prompt Sections protocol types.
+ *
+ * Source of truth for `prompt.sections.*` WS gateway RPC request/response shapes.
+ * Consumed by the minion gateway server handlers and by `minion_hub` / `minion_site`
+ * UI that drives the prompt engineering surface.
+ *
+ * Pure protocol types only — runtime validation (Zod) stays in `minion/` where the
+ * gateway handlers live. Keep this file import-free so both Node and browser bundles
+ * can consume it without pulling in server-only dependencies.
+ *
+ * Extracted from `minion/src/agents/sections/custom/types.ts` +
+ * `minion/src/gateway/server-methods/prompt-sections.ts` in Phase 20-01.
+ */
+export {};
+//# sourceMappingURL=prompt-sections.js.map

package/dist/prompt-sections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-sections.js","sourceRoot":"","sources":["../src/prompt-sections.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minion-stack/shared",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Shared gateway protocol types and utilities for the Minion platform.",
   "license": "MIT",
   "repository": {