@popcomputer/structured-chat 0.1.0 → 0.2.0

package/dist/core/view.js

@@ -1,8 +1,8 @@
-import { Effect, Either, Schema, unsafeCoerce } from "effect";
+import { Effect, Function as Fn, Result, Schema } from "effect";
 /** Stable machine-facing name for one structured chat view. */
-export const ViewNameSchema = Schema.NonEmptyTrimmedString.pipe(Schema.maxLength(100), Schema.pattern(/^[a-z0-9]+(?:[._-][a-z0-9]+)*$/));
+export const ViewNameSchema = Schema.Trimmed.check(Schema.isNonEmpty(), Schema.isMaxLength(100), Schema.isPattern(/^[a-z0-9]+(?:[._-][a-z0-9]+)*$/));
 /** Positive protocol version for one structured chat view. */
-export const ViewVersionSchema = Schema.Number.pipe(Schema.int(), Schema.between(1, 2_147_483_647));
+export const ViewVersionSchema = Schema.Number.check(Schema.isInt(), Schema.isBetween({ minimum: 1, maximum: 2_147_483_647 }));
 /**
  * Define one typed server-to-browser view contract.
  *
@@ -15,14 +15,10 @@ export const defineView = (definition) => {
     if ("schemaVersion" in definition.schema.fields) {
         throw new Error("View schemas cannot define the reserved schemaVersion field");
     }
-    // SAFETY: the reserved schemaVersion field cannot be supplied by Fields;
-    // the literal therefore augments the exact application schema once.
     const dataSchema = Schema.Struct({
         schemaVersion: Schema.Literal(definition.version),
         ...definition.schema.fields,
     });
-    // SAFETY: these literals and dataSchema exactly describe ViewPart<Name,
-    // Version, Fields>; the assertions retain that generic correlation.
     const partSchema = Schema.Struct({
         type: Schema.Literal("data"),
         name: Schema.Literal(definition.name),
@@ -30,14 +26,15 @@ export const defineView = (definition) => {
     });
     // SAFETY: NoContextFields excludes schemas with runtime requirements; this
     // assertion preserves definition.schema's existing Type and Encoded sides.
-    const runtimeInputSchema = unsafeCoerce(definition.schema);
+    const runtimeInputSchema = Fn.cast(definition.schema);
     // SAFETY: partSchema was built immediately above from the exact view name,
     // version, and application fields, with no runtime schema requirements.
-    const runtimePartSchema = unsafeCoerce(partSchema);
-    const decodePart = Schema.decodeUnknown(runtimePartSchema);
-    const decodePartEither = Schema.decodeUnknownEither(runtimePartSchema);
-    const validatePart = Schema.validate(runtimePartSchema);
-    const parseData = (input) => Schema.validate(runtimeInputSchema)(input, {
+    const runtimePartSchema = Fn.cast(partSchema);
+    const decodePart = Schema.decodeUnknownEffect(runtimePartSchema);
+    const decodePartResult = Schema.decodeUnknownResult(runtimePartSchema);
+    const validateInput = Schema.decodeUnknownEffect(Schema.toType(runtimeInputSchema));
+    const validatePart = Schema.decodeUnknownEffect(Schema.toType(runtimePartSchema));
+    const parseData = (input) => validateInput(input, {
         onExcessProperty: "error",
     }).pipe(Effect.flatMap((data) => validatePart({
         type: "data",
@@ -47,7 +44,7 @@ export const defineView = (definition) => {
             ...data,
         },
     }, { onExcessProperty: "error" })));
-    const make = (input) => Schema.validateSync(runtimePartSchema)({
+    const make = (input) => Schema.decodeUnknownSync(Schema.toType(runtimePartSchema))({
         type: "data",
         name: definition.name,
         data: {
@@ -64,6 +61,6 @@ export const defineView = (definition) => {
         make,
         parseData,
         decode: (input) => decodePart(input, { onExcessProperty: "error" }),
-        decodeEither: (input) => decodePartEither(input, { onExcessProperty: "error" }),
+        decodeResult: (input) => decodePartResult(input, { onExcessProperty: "error" }),
     };
 };

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 export { AssistantDataPartSchema, AssistantMessagePartSchema, AssistantTextPartSchema, CollectQuestionView, InvalidChatPresentation, presentAnswerValidationRejection, presentChatNotice, presentChatReply, StructuredChatAssistantMessageSchema, StructuredChatSessionReferenceSchema, StructuredChatTurnRequestSchema, StructuredChatTurnResponseSchema, Text, type AssistantMessagePart, type PresentChatReplyOptions, type StructuredChatAssistantMessage, type StructuredChatSessionReference, type StructuredChatTurnRequest, type StructuredChatTurnResponse, } from "./core/protocol.js";
+export { inspectChatState, InvalidChatDebugProjection, StructuredChatDebugSnapshotSchema, type InspectChatStateOptions, type StructuredChatDebugSnapshot, } from "./core/debug.js";
+export { presentChatDebugReply, StructuredChatDebugTurnResponseSchema, type PresentChatDebugReplyOptions, type StructuredChatDebugTurnResponse, } from "./core/debug-protocol.js";
 export { makeStructuredChatModel, ModelProvider, structuredChatModelLayer, StructuredChatModelIdSchema, StructuredChatProviderIdSchema, StructuredChatRequestTimeoutSchema, type CloudflareWorkersAIProviderConfig, type OpenAIProviderConfig, type StructuredChatModelConfig, type StructuredChatModelId, type StructuredChatProvider, type StructuredChatProviderId, type StructuredChatProviderRequest, } from "./adapters/openai-compatible-model.js";
 export { ChatNameSchema, ChatVersionSchema, defineChat, InvalidChatTransition, InvalidChatTransitionReasonSchema, type ChatDefinition, type ChatError, type ChatRequirements, type ChatReply, type ChatReplyError, type ChatReplyInput, type ChatStageStates, type ChatStageTuple, type ChatState, type ChatTurn, type DefineChatInput, } from "./core/chat.js";
 export { Answer, AnswerModeSchema, type AnswerDefinition, type AnswerDefinitionContract, type AnswerMode, type DefineAnswerInput, type DefineUnvalidatedAnswerInput, type DefineValidatedAnswerInput, } from "./core/answer.js";

package/dist/index.js

@@ -1,4 +1,6 @@
 export { AssistantDataPartSchema, AssistantMessagePartSchema, AssistantTextPartSchema, CollectQuestionView, InvalidChatPresentation, presentAnswerValidationRejection, presentChatNotice, presentChatReply, StructuredChatAssistantMessageSchema, StructuredChatSessionReferenceSchema, StructuredChatTurnRequestSchema, StructuredChatTurnResponseSchema, Text, } from "./core/protocol.js";
+export { inspectChatState, InvalidChatDebugProjection, StructuredChatDebugSnapshotSchema, } from "./core/debug.js";
+export { presentChatDebugReply, StructuredChatDebugTurnResponseSchema, } from "./core/debug-protocol.js";
 export { makeStructuredChatModel, ModelProvider, structuredChatModelLayer, StructuredChatModelIdSchema, StructuredChatProviderIdSchema, StructuredChatRequestTimeoutSchema, } from "./adapters/openai-compatible-model.js";
 export { ChatNameSchema, ChatVersionSchema, defineChat, InvalidChatTransition, InvalidChatTransitionReasonSchema, } from "./core/chat.js";
 export { Answer, AnswerModeSchema, } from "./core/answer.js";

package/dist/integrations/assistant-ui-debug.d.ts

@@ -0,0 +1,25 @@
+import type { StructuredChatDebugSnapshot } from "../core/debug.js";
+/** Viewport corner used by the structured-chat debug panel. */
+export type StructuredChatDebugPanelPosition = "top-left" | "top-right" | "bottom-left" | "bottom-right";
+/** Color treatment used by the structured-chat debug panel. */
+export type StructuredChatDebugPanelTheme = "system" | "light" | "dark";
+/** Explicit in-memory source consumed by one structured-chat debug panel. */
+export interface StructuredChatDebugStore {
+    /** Replace the current snapshot and notify active subscribers. */
+    readonly receive: (snapshot: StructuredChatDebugSnapshot) => void;
+    /** Subscribe to snapshot replacement. */
+    readonly subscribe: (listener: () => void) => () => void;
+    /** Read the current snapshot, or null before the first reply. */
+    readonly getSnapshot: () => StructuredChatDebugSnapshot | null;
+}
+/** Create one isolated structured-chat debug snapshot store. */
+export declare const createStructuredChatDebugStore: () => StructuredChatDebugStore;
+/** Props for the fixed, collapsible structured-chat debug panel. */
+export interface StructuredChatDebugPanelProps {
+    readonly store: StructuredChatDebugStore;
+    readonly position?: StructuredChatDebugPanelPosition;
+    readonly theme?: StructuredChatDebugPanelTheme;
+    readonly defaultOpen?: boolean;
+}
+/** Render one fixed, accessible inspector for the latest debug snapshot. */
+export declare const StructuredChatDebugPanel: ({ store, position, theme, defaultOpen, }: StructuredChatDebugPanelProps) => import("react").JSX.Element;