@undefineds.co/models 0.1.1 → 0.2.0

package/dist/{sidecar/sidecar-events.d.ts → protocols/runtime-events.d.ts}

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-export type SidecarEventType = 'tool.call' | 'session.state' | 'tool.control' | 'inbox.approval';
-export type SidecarEventVersion = 1;
+export type RuntimeEventType = 'tool.call' | 'session.state' | 'tool.control' | 'inbox.approval';
+export type RuntimeEventVersion = 1;
 export declare const RiskLevelSchema: z.ZodEnum<["low", "medium", "high"]>;
 export type RiskLevel = z.infer<typeof RiskLevelSchema>;
 export declare const DecisionRoleSchema: z.ZodEnum<["human", "secretary", "system"]>;
@@ -148,7 +148,7 @@ export declare const SessionStateEventV1Schema: z.ZodObject<{
     timestamp: z.ZodString;
 }, "strict", z.ZodTypeAny, {
     type: "session.state";
-    status: "active" | "error" | "paused" | "completed";
+    status: "active" | "error" | "completed" | "paused";
     tokenUsage: number;
     chatId: string;
     tool: "claude-code" | "cursor" | "windsurf";
@@ -160,7 +160,7 @@ export declare const SessionStateEventV1Schema: z.ZodObject<{
     version?: 1 | undefined;
 }, {
     type: "session.state";
-    status: "active" | "error" | "paused" | "completed";
+    status: "active" | "error" | "completed" | "paused";
     tokenUsage: number;
     chatId: string;
     tool: "claude-code" | "cursor" | "windsurf";
@@ -185,7 +185,7 @@ export declare const SessionStateEventSchema: z.ZodObject<{
     timestamp: z.ZodString;
 }, "strict", z.ZodTypeAny, {
     type: "session.state";
-    status: "active" | "error" | "paused" | "completed";
+    status: "active" | "error" | "completed" | "paused";
     tokenUsage: number;
     chatId: string;
     tool: "claude-code" | "cursor" | "windsurf";
@@ -197,7 +197,7 @@ export declare const SessionStateEventSchema: z.ZodObject<{
     version?: 1 | undefined;
 }, {
     type: "session.state";
-    status: "active" | "error" | "paused" | "completed";
+    status: "active" | "error" | "completed" | "paused";
     tokenUsage: number;
     chatId: string;
     tool: "claude-code" | "cursor" | "windsurf";
@@ -427,7 +427,7 @@ export declare const InboxApprovalEventSchema: z.ZodObject<{
     version?: 1 | undefined;
 }>;
 export type InboxApprovalEvent = z.infer<typeof InboxApprovalEventSchema>;
-export declare const SidecarEventSchema: z.ZodUnion<[z.ZodObject<{
+export declare const RuntimeEventSchema: z.ZodUnion<[z.ZodObject<{
     type: z.ZodLiteral<"tool.call">;
     version: z.ZodOptional<z.ZodLiteral<1>>;
     sessionId: z.ZodString;
@@ -501,7 +501,7 @@ export declare const SidecarEventSchema: z.ZodUnion<[z.ZodObject<{
     timestamp: z.ZodString;
 }, "strict", z.ZodTypeAny, {
     type: "session.state";
-    status: "active" | "error" | "paused" | "completed";
+    status: "active" | "error" | "completed" | "paused";
     tokenUsage: number;
     chatId: string;
     tool: "claude-code" | "cursor" | "windsurf";
@@ -513,7 +513,7 @@ export declare const SidecarEventSchema: z.ZodUnion<[z.ZodObject<{
     version?: 1 | undefined;
 }, {
     type: "session.state";
-    status: "active" | "error" | "paused" | "completed";
+    status: "active" | "error" | "completed" | "paused";
     tokenUsage: number;
     chatId: string;
     tool: "claude-code" | "cursor" | "windsurf";
@@ -628,5 +628,5 @@ export declare const SidecarEventSchema: z.ZodUnion<[z.ZodObject<{
     policyVersion?: string | undefined;
     version?: 1 | undefined;
 }>]>;
-export type SidecarEvent = z.infer<typeof SidecarEventSchema>;
-export declare function getSidecarEventVersion(_event: SidecarEvent): SidecarEventVersion;
+export type RuntimeEvent = z.infer<typeof RuntimeEventSchema>;
+export declare function getRuntimeEventVersion(_event: RuntimeEvent): RuntimeEventVersion;

package/dist/{sidecar/sidecar-events.js → protocols/runtime-events.js}

@@ -11,9 +11,6 @@ export const ToolCallStatusSchema = z.enum([
     'error',
 ]);
 const IsoDatetimeSchema = z.string().datetime();
-// --------------------------------------------
-// tool.call
-// --------------------------------------------
 export const ToolCallEventV1Schema = z
     .object({
     type: z.literal('tool.call'),
@@ -23,7 +20,6 @@ export const ToolCallEventV1Schema = z
     toolName: z.string(),
     risk: RiskLevelSchema.optional(),
     status: ToolCallStatusSchema,
-    // CP0 Pod-only scope projection
     target: z.string().optional(),
     action: z.string().optional(),
     arguments: z.record(z.unknown()).optional(),
@@ -31,17 +27,14 @@ export const ToolCallEventV1Schema = z
     error: z.string().optional(),
     duration: z.number().int().nonnegative().optional(),
     inboxItemId: z.string().optional(),
-    decisionBy: z.string().optional(), // WebID
+    decisionBy: z.string().optional(),
     decisionRole: DecisionRoleSchema.optional(),
-    onBehalfOf: z.string().optional(), // WebID
+    onBehalfOf: z.string().optional(),
     policyVersion: z.string().optional(),
     timestamp: IsoDatetimeSchema,
 })
     .strict();
 export const ToolCallEventSchema = ToolCallEventV1Schema;
-// --------------------------------------------
-// session.state
-// --------------------------------------------
 export const SessionToolSchema = z.enum(['claude-code', 'cursor', 'windsurf']);
 export const SessionStatusSchema = z.enum(['active', 'paused', 'completed', 'error']);
 export const SessionStateEventV1Schema = z
@@ -60,9 +53,6 @@ export const SessionStateEventV1Schema = z
 })
     .strict();
 export const SessionStateEventSchema = SessionStateEventV1Schema;
-// --------------------------------------------
-// tool.control
-// --------------------------------------------
 export const ToolControlCommandNameSchema = z.enum([
     'approve',
     'reject',
@@ -95,9 +85,6 @@ export const ToolControlCommandV1Schema = z
 })
     .strict();
 export const ToolControlCommandSchema = ToolControlCommandV1Schema;
-// --------------------------------------------
-// inbox.approval
-// --------------------------------------------
 export const InboxApprovalStatusSchema = z.enum(['pending', 'approved', 'rejected', 'expired']);
 export const InboxApprovalEventV1Schema = z
     .object({
@@ -106,7 +93,6 @@ export const InboxApprovalEventV1Schema = z
     inboxItemId: z.string(),
     sessionId: z.string(),
     toolCallId: z.string(),
-    // Optional Pod scope projection
     target: z.string().optional(),
     action: z.string().optional(),
     policy: z.string().optional(),
@@ -119,15 +105,12 @@ export const InboxApprovalEventV1Schema = z
 })
     .strict();
 export const InboxApprovalEventSchema = InboxApprovalEventV1Schema;
-// --------------------------------------------
-// SidecarEvent
-// --------------------------------------------
-export const SidecarEventSchema = z.union([
+export const RuntimeEventSchema = z.union([
     ToolCallEventSchema,
     SessionStateEventSchema,
     ToolControlCommandSchema,
     InboxApprovalEventSchema,
 ]);
-export function getSidecarEventVersion(_event) {
+export function getRuntimeEventVersion(_event) {
     return 1;
 }

package/dist/schema.d.ts

@@ -1 +1 @@
-export { linxSchema } from './core.js';
+export { schema } from './core.js';

package/dist/schema.js

@@ -1 +1 @@
-export { linxSchema } from './core.js';
+export { schema } from './core.js';

package/dist/types/{collaboration-blocks.d.ts → collaboration-rich-content.d.ts}

@@ -1,12 +1,12 @@
 /**
- * Wave A CP0: collaboration-related richContent block contracts.
+ * Wave A CP0: collaboration-related rich content items.
  *
- * These are minimal JSON shapes stored in MessageRow.richContent and consumed by downstream UIs.
- * They intentionally do NOT include UI block runtime fields (id/createdAt/status, etc.).
+ * These are data contracts stored in `MessageRow.richContent.items`.
+ * They intentionally omit presentation/runtime wrapper fields.
  */
 export type ToolRisk = 'low' | 'medium' | 'high';
 export type ToolApprovalStatus = 'pending' | 'approved' | 'rejected' | 'auto_approved';
-export interface ToolApprovalBlock {
+export interface ToolApprovalRichContentItem {
     type: 'tool_approval';
     toolCallId: string;
     toolName: string;
@@ -24,7 +24,7 @@ export interface ToolApprovalBlock {
     inboxItemId?: string;
 }
 export type TaskProgressStepStatus = 'pending' | 'running' | 'done' | 'error' | 'skipped';
-export interface TaskProgressBlock {
+export interface TaskProgressRichContentItem {
     type: 'task_progress';
     taskId: string;
     title: string;
@@ -39,7 +39,7 @@ export interface TaskProgressBlock {
     totalSteps: number;
 }
 export type ToolCallStatus = 'calling' | 'waiting_approval' | 'running' | 'done' | 'error';
-export interface ToolCallBlock {
+export interface ToolCallRichContentItem {
     type: 'tool';
     toolCallId: string;
     toolName: string;
@@ -49,4 +49,4 @@ export interface ToolCallBlock {
     error?: string;
     duration?: number;
 }
-export type CollaborationRichBlock = ToolApprovalBlock | TaskProgressBlock | ToolCallBlock;
+export type CollaborationRichContentItem = ToolApprovalRichContentItem | TaskProgressRichContentItem | ToolCallRichContentItem;

package/dist/types/collaboration-rich-content.js

@@ -0,0 +1,7 @@
+/**
+ * Wave A CP0: collaboration-related rich content items.
+ *
+ * These are data contracts stored in `MessageRow.richContent.items`.
+ * They intentionally omit presentation/runtime wrapper fields.
+ */
+export {};

package/dist/types/message-rich-content.d.ts

@@ -0,0 +1,121 @@
+import type { ToolApprovalRichContentItem, ToolCallRichContentItem, TaskProgressRichContentItem } from './collaboration-rich-content.js';
+/**
+ * Message rich content item kinds stored in `MessageRow.richContent`.
+ */
+export declare enum RichContentItemType {
+    MAIN_TEXT = "main_text",
+    THINKING = "thinking",
+    IMAGE = "image",
+    CODE = "code",
+    TOOL = "tool",
+    TOOL_APPROVAL = "tool_approval",
+    TASK_PROGRESS = "task_progress",
+    FILE = "file",
+    ERROR = "error",
+    CITATION = "citation"
+}
+export interface RichContentModelRef {
+    id: string;
+    name: string;
+    provider: string;
+}
+export interface BaseRichContentItem {
+    type: RichContentItemType;
+    model?: RichContentModelRef;
+    metadata?: Record<string, unknown>;
+}
+export interface MainTextRichContentItem extends BaseRichContentItem {
+    type: RichContentItemType.MAIN_TEXT;
+    content: string;
+    knowledgeBaseIds?: string[];
+    citationReferences?: Array<{
+        citationItemId?: string;
+        url?: string;
+        title?: string;
+    }>;
+}
+export interface ThinkingRichContentItem extends BaseRichContentItem {
+    type: RichContentItemType.THINKING;
+    content: string;
+    thinkingDuration?: number;
+}
+export interface CodeRichContentItem extends BaseRichContentItem {
+    type: RichContentItemType.CODE;
+    content: string;
+    language: string;
+    executable?: boolean;
+    executionResult?: {
+        output?: string;
+        error?: string;
+        exitCode?: number;
+    };
+}
+export interface ImageRichContentItem extends BaseRichContentItem {
+    type: RichContentItemType.IMAGE;
+    url?: string;
+    filePath?: string;
+    metadata?: BaseRichContentItem['metadata'] & {
+        prompt?: string;
+        negativePrompt?: string;
+        fileName?: string;
+        fileSize?: number;
+        width?: number;
+        height?: number;
+    };
+}
+export interface CitationRichContentItem extends BaseRichContentItem {
+    type: RichContentItemType.CITATION;
+    webSearch?: {
+        query: string;
+        results: Array<{
+            title: string;
+            url: string;
+            snippet?: string;
+            favicon?: string;
+        }>;
+    };
+    knowledge?: Array<{
+        id: string;
+        title: string;
+        content: string;
+        source?: string;
+    }>;
+}
+export interface FileRichContentItem extends BaseRichContentItem {
+    type: RichContentItemType.FILE;
+    fileName: string;
+    fileUrl: string;
+    fileSize?: number;
+    mimeType?: string;
+}
+export interface ErrorRichContentItem extends BaseRichContentItem {
+    type: RichContentItemType.ERROR;
+    message: string;
+    retryable?: boolean;
+    code?: string;
+    details?: unknown;
+}
+export type MessageRichContentItem = MainTextRichContentItem | ThinkingRichContentItem | CodeRichContentItem | ImageRichContentItem | ToolCallRichContentItem | ToolApprovalRichContentItem | TaskProgressRichContentItem | FileRichContentItem | ErrorRichContentItem | CitationRichContentItem;
+export interface LegacyToolInvocation {
+    id: string;
+    toolName: string;
+    input: unknown;
+    output?: unknown;
+    error?: string;
+}
+/**
+ * Message.richContent payload.
+ */
+export interface MessageRichContent {
+    thought?: string;
+    toolInvocations?: LegacyToolInvocation[];
+    items?: MessageRichContentItem[];
+}
+export declare function createRichContentItem<T extends MessageRichContentItem>(type: T['type'], partial: Omit<T, 'type'>): T;
+export declare function isRichContentItemType<TType extends MessageRichContentItem['type']>(item: MessageRichContentItem, type: TType): item is Extract<MessageRichContentItem, {
+    type: TType;
+}>;
+export declare function parseMessageRichContent(richContent: string | null | undefined): MessageRichContent;
+export declare function parseMessageRichContentItems(richContent: string | null | undefined): MessageRichContentItem[];
+export declare function serializeMessageRichContent(content: MessageRichContent): string;
+export declare function serializeMessageRichContentItems(items: MessageRichContentItem[]): string;

package/dist/types/message-rich-content.js

@@ -0,0 +1,85 @@
+/**
+ * Message rich content item kinds stored in `MessageRow.richContent`.
+ */
+export var RichContentItemType;
+(function (RichContentItemType) {
+    RichContentItemType["MAIN_TEXT"] = "main_text";
+    RichContentItemType["THINKING"] = "thinking";
+    RichContentItemType["IMAGE"] = "image";
+    RichContentItemType["CODE"] = "code";
+    RichContentItemType["TOOL"] = "tool";
+    RichContentItemType["TOOL_APPROVAL"] = "tool_approval";
+    RichContentItemType["TASK_PROGRESS"] = "task_progress";
+    RichContentItemType["FILE"] = "file";
+    RichContentItemType["ERROR"] = "error";
+    RichContentItemType["CITATION"] = "citation";
+})(RichContentItemType || (RichContentItemType = {}));
+function toToolArguments(input) {
+    if (input !== null && typeof input === 'object' && !Array.isArray(input)) {
+        return input;
+    }
+    return { value: input };
+}
+function normalizeLegacyItems(payload) {
+    const items = [];
+    if (payload.thought) {
+        items.push({
+            type: RichContentItemType.THINKING,
+            content: payload.thought,
+        });
+    }
+    if (payload.toolInvocations) {
+        payload.toolInvocations.forEach((toolInvocation) => {
+            items.push({
+                type: RichContentItemType.TOOL,
+                toolCallId: toolInvocation.id,
+                toolName: toolInvocation.toolName,
+                arguments: toToolArguments(toolInvocation.input),
+                status: toolInvocation.error ? 'error' : 'done',
+                result: toolInvocation.output,
+                error: toolInvocation.error,
+            });
+        });
+    }
+    return items;
+}
+export function createRichContentItem(type, partial) {
+    return {
+        type,
+        ...partial,
+    };
+}
+export function isRichContentItemType(item, type) {
+    return item.type === type;
+}
+export function parseMessageRichContent(richContent) {
+    if (!richContent) {
+        return { items: [] };
+    }
+    try {
+        const parsed = JSON.parse(richContent);
+        const { blocks, items, ...rest } = parsed;
+        if (Array.isArray(items)) {
+            return { ...rest, items };
+        }
+        if (Array.isArray(blocks)) {
+            return { ...rest, items: blocks };
+        }
+        return {
+            ...rest,
+            items: normalizeLegacyItems(parsed),
+        };
+    }
+    catch {
+        return { items: [] };
+    }
+}
+export function parseMessageRichContentItems(richContent) {
+    return parseMessageRichContent(richContent).items ?? [];
+}
+export function serializeMessageRichContent(content) {
+    return JSON.stringify(content);
+}
+export function serializeMessageRichContentItems(items) {
+    return serializeMessageRichContent({ items });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@undefineds.co/models",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -27,6 +27,14 @@
       "types": "./dist/ai-config/index.d.ts",
       "default": "./dist/ai-config/index.js"
     },
+    "./protocols": {
+      "types": "./dist/protocols/index.d.ts",
+      "default": "./dist/protocols/index.js"
+    },
+    "./governance": {
+      "types": "./dist/governance/index.d.ts",
+      "default": "./dist/governance/index.js"
+    },
     "./_drizzle-solid/pod-table": {
       "types": "./dist/_drizzle-solid/pod-table.d.ts",
       "default": "./dist/_drizzle-solid/pod-table.js"

package/dist/core/types/collaboration-blocks.js

@@ -1,7 +0,0 @@
-/**
- * Wave A CP0: collaboration-related richContent block contracts.
- *
- * These are minimal JSON shapes stored in MessageRow.richContent and consumed by downstream UIs.
- * They intentionally do NOT include UI block runtime fields (id/createdAt/status, etc.).
- */
-export {};