@octavus/core 0.0.1

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Octavus AI
+
+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/dist/index.d.ts

@@ -0,0 +1,324 @@
+import { z } from 'zod';
+
+declare class AppError extends Error {
+    code: string;
+    statusCode: number;
+    constructor(message: string, code: string, statusCode?: number);
+}
+declare class NotFoundError extends AppError {
+    constructor(resource: string, id: string);
+}
+declare class ValidationError extends AppError {
+    issues?: unknown[] | undefined;
+    constructor(message: string, issues?: unknown[] | undefined);
+}
+declare class ConflictError extends AppError {
+    constructor(resource: string, identifier: string);
+}
+
+/**
+ * Generate a unique ID for messages, tool calls, etc.
+ * Format: timestamp-random (e.g., "1702345678901-abc123def")
+ */
+declare function generateId(): string;
+
+/**
+ * Display mode - controls execution indicator visibility (NOT final message visibility).
+ * - hidden: Block runs silently
+ * - name: Shows block/tool name
+ * - description: Shows description
+ * - stream: Shows live streaming content
+ */
+type DisplayMode = 'hidden' | 'name' | 'description' | 'stream';
+type ToolHandler = (args: Record<string, unknown>) => Promise<unknown>;
+type ToolHandlers = Record<string, ToolHandler>;
+type ResourceUpdateHandler = (name: string, value: unknown) => Promise<void> | void;
+type MessageRole = 'user' | 'assistant' | 'system';
+type ToolCallStatus = 'pending' | 'in_progress' | 'completed' | 'error';
+interface ToolCallInfo {
+    id: string;
+    name: string;
+    description?: string;
+    arguments: Record<string, unknown>;
+    status: ToolCallStatus;
+    result?: unknown;
+    error?: string;
+}
+interface TextDeltaEvent {
+    type: 'text-delta';
+    content: string;
+}
+interface TextStartEvent {
+    type: 'text-start';
+    id: string;
+}
+interface TextEndEvent {
+    type: 'text-end';
+    id: string;
+}
+interface ToolCallStartEvent {
+    type: 'tool-call-start';
+    toolCallId: string;
+    toolName: string;
+    toolDescription?: string;
+    toolDisplay?: DisplayMode;
+}
+interface ToolCallArgsEvent {
+    type: 'tool-call-args';
+    toolCallId: string;
+    argsJson: string;
+}
+interface ToolCallResultEvent {
+    type: 'tool-call-result';
+    toolCallId: string;
+    result: unknown;
+}
+interface ToolCallErrorEvent {
+    type: 'tool-call-error';
+    toolCallId: string;
+    error: string;
+}
+interface ResourceUpdateEvent {
+    type: 'resource-update';
+    name: string;
+    value: unknown;
+}
+interface DoneEvent {
+    type: 'done';
+    finishReason: 'stop' | 'tool-calls' | 'length' | 'error' | 'unknown';
+}
+interface ErrorEvent {
+    type: 'error';
+    message: string;
+    code?: string;
+}
+interface BlockStartEvent {
+    type: 'block-start';
+    blockId: string;
+    blockName: string;
+    blockType: string;
+    display: DisplayMode;
+    description?: string;
+    /** Whether output goes to main chat (false for independent blocks) */
+    outputToChat?: boolean;
+}
+interface BlockEndEvent {
+    type: 'block-end';
+    blockId: string;
+    summary?: string;
+}
+interface ThinkingStartEvent {
+    type: 'thinking-start';
+    id: string;
+    thread?: string;
+}
+interface ThinkingDeltaEvent {
+    type: 'thinking-delta';
+    content: string;
+    thread?: string;
+}
+interface ThinkingEndEvent {
+    type: 'thinking-end';
+    id: string;
+}
+interface PendingToolCall {
+    toolCallId: string;
+    toolName: string;
+    args: Record<string, unknown>;
+    /** 'llm' for LLM-initiated, 'block' for protocol block */
+    source?: 'llm' | 'block';
+    /** For block-based tools: variable name to store result in */
+    outputVariable?: string;
+    /** For block-based tools: block index to resume from after execution */
+    blockIndex?: number;
+}
+/**
+ * When this event is received, the stream will close.
+ * Consumer should execute the tools and POST a new trigger request with toolResults.
+ */
+interface ToolRequestEvent {
+    type: 'tool-request';
+    toolCalls: PendingToolCall[];
+}
+interface ToolResult {
+    toolCallId: string;
+    toolName?: string;
+    result?: unknown;
+    error?: string;
+    outputVariable?: string;
+    blockIndex?: number;
+}
+type StreamEvent = TextDeltaEvent | TextStartEvent | TextEndEvent | ToolCallStartEvent | ToolCallArgsEvent | ToolCallResultEvent | ToolCallErrorEvent | ToolRequestEvent | ResourceUpdateEvent | BlockStartEvent | BlockEndEvent | ThinkingStartEvent | ThinkingDeltaEvent | ThinkingEndEvent | DoneEvent | ErrorEvent;
+/**
+ * Type of content in a message part
+ */
+type MessagePartType = 'text' | 'thinking' | 'tool-call';
+/**
+ * A single part of a message, stored in order for proper display
+ */
+interface MessagePart {
+    type: MessagePartType;
+    /** Whether shown in chat UI (false = LLM sees it, user doesn't) */
+    visible: boolean;
+    /** Content for text/thinking parts */
+    content?: string;
+    /** Tool call info for tool-call parts */
+    toolCall?: ToolCallInfo;
+    /** Thread name for non-main-thread content (e.g., "summary") */
+    thread?: string;
+}
+interface ChatMessage {
+    id: string;
+    role: MessageRole;
+    /** Ordered parts for display - preserves thinking/tool/text order */
+    parts: MessagePart[];
+    createdAt: string;
+    /**
+     * Whether shown in chat UI (false = LLM sees it, user doesn't).
+     * Use for internal directives. Different from `display` which controls execution indicator.
+     * @default true
+     */
+    visible?: boolean;
+    content: string;
+    toolCalls?: ToolCallInfo[];
+    reasoning?: string;
+    /** Required by Anthropic to verify thinking blocks */
+    reasoningSignature?: string;
+}
+
+/**
+ * Schema for tool result (consumer's response to tool-request)
+ */
+declare const toolResultSchema: z.ZodObject<{
+    toolCallId: z.ZodString;
+    toolName: z.ZodOptional<z.ZodString>;
+    result: z.ZodOptional<z.ZodUnknown>;
+    error: z.ZodOptional<z.ZodString>;
+    outputVariable: z.ZodOptional<z.ZodString>;
+    blockIndex: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+declare const chatMessageSchema: z.ZodObject<{
+    id: z.ZodString;
+    role: z.ZodEnum<{
+        user: "user";
+        assistant: "assistant";
+        system: "system";
+    }>;
+    parts: z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            text: "text";
+            thinking: "thinking";
+            "tool-call": "tool-call";
+        }>;
+        visible: z.ZodBoolean;
+        content: z.ZodOptional<z.ZodString>;
+        toolCall: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            arguments: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            status: z.ZodEnum<{
+                pending: "pending";
+                in_progress: "in_progress";
+                completed: "completed";
+                error: "error";
+            }>;
+            result: z.ZodOptional<z.ZodUnknown>;
+            error: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        thread: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    createdAt: z.ZodString;
+    visible: z.ZodOptional<z.ZodBoolean>;
+    content: z.ZodString;
+    toolCalls: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        arguments: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        status: z.ZodEnum<{
+            pending: "pending";
+            in_progress: "in_progress";
+            completed: "completed";
+            error: "error";
+        }>;
+        result: z.ZodOptional<z.ZodUnknown>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    reasoning: z.ZodOptional<z.ZodString>;
+    reasoningSignature: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare function safeParseStreamEvent(data: unknown): z.ZodSafeParseResult<{
+    type: "text-delta";
+    content: string;
+} | {
+    type: "text-start";
+    id: string;
+} | {
+    type: "text-end";
+    id: string;
+} | {
+    type: "tool-call-start";
+    toolCallId: string;
+    toolName: string;
+    toolDescription?: string | undefined;
+    toolDisplay?: "hidden" | "name" | "description" | "stream" | undefined;
+} | {
+    type: "tool-call-args";
+    toolCallId: string;
+    argsJson: string;
+} | {
+    type: "tool-call-result";
+    toolCallId: string;
+    result: unknown;
+} | {
+    type: "tool-call-error";
+    toolCallId: string;
+    error: string;
+} | {
+    type: "tool-request";
+    toolCalls: {
+        toolCallId: string;
+        toolName: string;
+        args: Record<string, unknown>;
+        source?: "llm" | "block" | undefined;
+        outputVariable?: string | undefined;
+        blockIndex?: number | undefined;
+    }[];
+} | {
+    type: "resource-update";
+    name: string;
+    value: unknown;
+} | {
+    type: "block-start";
+    blockId: string;
+    blockName: string;
+    blockType: string;
+    display: "hidden" | "name" | "description" | "stream";
+    description?: string | undefined;
+    outputToChat?: boolean | undefined;
+} | {
+    type: "block-end";
+    blockId: string;
+    summary?: string | undefined;
+} | {
+    type: "thinking-start";
+    id: string;
+    thread?: string | undefined;
+} | {
+    type: "thinking-delta";
+    content: string;
+    thread?: string | undefined;
+} | {
+    type: "thinking-end";
+    id: string;
+} | {
+    type: "done";
+    finishReason: "error" | "stop" | "tool-calls" | "length" | "unknown";
+} | {
+    type: "error";
+    message: string;
+    code?: string | undefined;
+}>;
+
+export { AppError, type BlockEndEvent, type BlockStartEvent, type ChatMessage, ConflictError, type DisplayMode, type DoneEvent, type ErrorEvent, type MessagePart, type MessagePartType, type MessageRole, NotFoundError, type PendingToolCall, type ResourceUpdateEvent, type ResourceUpdateHandler, type StreamEvent, type TextDeltaEvent, type TextEndEvent, type TextStartEvent, type ThinkingDeltaEvent, type ThinkingEndEvent, type ThinkingStartEvent, type ToolCallArgsEvent, type ToolCallErrorEvent, type ToolCallInfo, type ToolCallResultEvent, type ToolCallStartEvent, type ToolCallStatus, type ToolHandler, type ToolHandlers, type ToolRequestEvent, type ToolResult, ValidationError, chatMessageSchema, generateId, safeParseStreamEvent, toolResultSchema };

package/dist/index.js

@@ -0,0 +1,196 @@
+// src/errors.ts
+var AppError = class extends Error {
+  constructor(message, code, statusCode = 500) {
+    super(message);
+    this.code = code;
+    this.statusCode = statusCode;
+    this.name = "AppError";
+  }
+};
+var NotFoundError = class extends AppError {
+  constructor(resource, id) {
+    super(`${resource} not found: ${id}`, "NOT_FOUND", 404);
+    this.name = "NotFoundError";
+  }
+};
+var ValidationError = class extends AppError {
+  constructor(message, issues) {
+    super(message, "VALIDATION_ERROR", 400);
+    this.issues = issues;
+    this.name = "ValidationError";
+  }
+};
+var ConflictError = class extends AppError {
+  constructor(resource, identifier) {
+    super(`${resource} already exists: ${identifier}`, "CONFLICT", 409);
+    this.name = "ConflictError";
+  }
+};
+
+// src/utils.ts
+function generateId() {
+  return `${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
+}
+
+// src/stream/schemas.ts
+import { z } from "zod";
+var displayModeSchema = z.enum(["hidden", "name", "description", "stream"]);
+var messageRoleSchema = z.enum(["user", "assistant", "system"]);
+var toolCallStatusSchema = z.enum(["pending", "in_progress", "completed", "error"]);
+var finishReasonSchema = z.enum(["stop", "tool-calls", "length", "error", "unknown"]);
+var toolCallInfoSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  description: z.string().optional(),
+  arguments: z.record(z.string(), z.unknown()),
+  status: toolCallStatusSchema,
+  result: z.unknown().optional(),
+  error: z.string().optional()
+});
+var textDeltaEventSchema = z.object({
+  type: z.literal("text-delta"),
+  content: z.string()
+});
+var textStartEventSchema = z.object({
+  type: z.literal("text-start"),
+  id: z.string()
+});
+var textEndEventSchema = z.object({
+  type: z.literal("text-end"),
+  id: z.string()
+});
+var toolCallStartEventSchema = z.object({
+  type: z.literal("tool-call-start"),
+  toolCallId: z.string(),
+  toolName: z.string(),
+  toolDescription: z.string().optional(),
+  toolDisplay: displayModeSchema.optional()
+});
+var toolCallArgsEventSchema = z.object({
+  type: z.literal("tool-call-args"),
+  toolCallId: z.string(),
+  argsJson: z.string()
+});
+var toolCallResultEventSchema = z.object({
+  type: z.literal("tool-call-result"),
+  toolCallId: z.string(),
+  result: z.unknown()
+});
+var toolCallErrorEventSchema = z.object({
+  type: z.literal("tool-call-error"),
+  toolCallId: z.string(),
+  error: z.string()
+});
+var resourceUpdateEventSchema = z.object({
+  type: z.literal("resource-update"),
+  name: z.string(),
+  value: z.unknown()
+});
+var doneEventSchema = z.object({
+  type: z.literal("done"),
+  finishReason: finishReasonSchema
+});
+var errorEventSchema = z.object({
+  type: z.literal("error"),
+  message: z.string(),
+  code: z.string().optional()
+});
+var blockStartEventSchema = z.object({
+  type: z.literal("block-start"),
+  blockId: z.string(),
+  blockName: z.string(),
+  blockType: z.string(),
+  display: displayModeSchema,
+  description: z.string().optional(),
+  outputToChat: z.boolean().optional()
+});
+var blockEndEventSchema = z.object({
+  type: z.literal("block-end"),
+  blockId: z.string(),
+  summary: z.string().optional()
+});
+var thinkingStartEventSchema = z.object({
+  type: z.literal("thinking-start"),
+  id: z.string(),
+  thread: z.string().optional()
+});
+var thinkingDeltaEventSchema = z.object({
+  type: z.literal("thinking-delta"),
+  content: z.string(),
+  thread: z.string().optional()
+});
+var thinkingEndEventSchema = z.object({
+  type: z.literal("thinking-end"),
+  id: z.string()
+});
+var pendingToolCallSchema = z.object({
+  toolCallId: z.string(),
+  toolName: z.string(),
+  args: z.record(z.string(), z.unknown()),
+  source: z.enum(["llm", "block"]).optional(),
+  outputVariable: z.string().optional(),
+  blockIndex: z.number().optional()
+});
+var toolRequestEventSchema = z.object({
+  type: z.literal("tool-request"),
+  toolCalls: z.array(pendingToolCallSchema)
+});
+var toolResultSchema = z.object({
+  toolCallId: z.string(),
+  toolName: z.string().optional(),
+  result: z.unknown().optional(),
+  error: z.string().optional(),
+  outputVariable: z.string().optional(),
+  blockIndex: z.number().optional()
+});
+var streamEventSchema = z.discriminatedUnion("type", [
+  textDeltaEventSchema,
+  textStartEventSchema,
+  textEndEventSchema,
+  toolCallStartEventSchema,
+  toolCallArgsEventSchema,
+  toolCallResultEventSchema,
+  toolCallErrorEventSchema,
+  toolRequestEventSchema,
+  resourceUpdateEventSchema,
+  blockStartEventSchema,
+  blockEndEventSchema,
+  thinkingStartEventSchema,
+  thinkingDeltaEventSchema,
+  thinkingEndEventSchema,
+  doneEventSchema,
+  errorEventSchema
+]);
+var messagePartTypeSchema = z.enum(["text", "thinking", "tool-call"]);
+var messagePartSchema = z.object({
+  type: messagePartTypeSchema,
+  visible: z.boolean(),
+  content: z.string().optional(),
+  toolCall: toolCallInfoSchema.optional(),
+  thread: z.string().optional()
+});
+var chatMessageSchema = z.object({
+  id: z.string(),
+  role: messageRoleSchema,
+  parts: z.array(messagePartSchema),
+  createdAt: z.string(),
+  visible: z.boolean().optional(),
+  content: z.string(),
+  toolCalls: z.array(toolCallInfoSchema).optional(),
+  reasoning: z.string().optional(),
+  reasoningSignature: z.string().optional()
+});
+function safeParseStreamEvent(data) {
+  return streamEventSchema.safeParse(data);
+}
+export {
+  AppError,
+  ConflictError,
+  NotFoundError,
+  ValidationError,
+  chatMessageSchema,
+  generateId,
+  safeParseStreamEvent,
+  toolResultSchema
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/utils.ts","../src/stream/schemas.ts"],"sourcesContent":["export class AppError extends Error {\n  constructor(\n    message: string,\n    public code: string,\n    public statusCode = 500,\n  ) {\n    super(message);\n    this.name = 'AppError';\n  }\n}\n\nexport class NotFoundError extends AppError {\n  constructor(resource: string, id: string) {\n    super(`${resource} not found: ${id}`, 'NOT_FOUND', 404);\n    this.name = 'NotFoundError';\n  }\n}\n\nexport class ValidationError extends AppError {\n  constructor(\n    message: string,\n    public issues?: unknown[],\n  ) {\n    super(message, 'VALIDATION_ERROR', 400);\n    this.name = 'ValidationError';\n  }\n}\n\nexport class ConflictError extends AppError {\n  constructor(resource: string, identifier: string) {\n    super(`${resource} already exists: ${identifier}`, 'CONFLICT', 409);\n    this.name = 'ConflictError';\n  }\n}\n","/**\n * Generate a unique ID for messages, tool calls, etc.\n * Format: timestamp-random (e.g., \"1702345678901-abc123def\")\n */\nexport function generateId(): string {\n  return `${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;\n}\n","import { z } from 'zod';\n\nexport const displayModeSchema = z.enum(['hidden', 'name', 'description', 'stream']);\nexport const messageRoleSchema = z.enum(['user', 'assistant', 'system']);\nexport const toolCallStatusSchema = z.enum(['pending', 'in_progress', 'completed', 'error']);\nexport const finishReasonSchema = z.enum(['stop', 'tool-calls', 'length', 'error', 'unknown']);\n\n// ToolCallInfo\nexport const toolCallInfoSchema = z.object({\n  id: z.string(),\n  name: z.string(),\n  description: z.string().optional(),\n  arguments: z.record(z.string(), z.unknown()),\n  status: toolCallStatusSchema,\n  result: z.unknown().optional(),\n  error: z.string().optional(),\n});\n\n// Stream Events\nexport const textDeltaEventSchema = z.object({\n  type: z.literal('text-delta'),\n  content: z.string(),\n});\n\nexport const textStartEventSchema = z.object({\n  type: z.literal('text-start'),\n  id: z.string(),\n});\n\nexport const textEndEventSchema = z.object({\n  type: z.literal('text-end'),\n  id: z.string(),\n});\n\nexport const toolCallStartEventSchema = z.object({\n  type: z.literal('tool-call-start'),\n  toolCallId: z.string(),\n  toolName: z.string(),\n  toolDescription: z.string().optional(),\n  toolDisplay: displayModeSchema.optional(),\n});\n\nexport const toolCallArgsEventSchema = z.object({\n  type: z.literal('tool-call-args'),\n  toolCallId: z.string(),\n  argsJson: z.string(),\n});\n\nexport const toolCallResultEventSchema = z.object({\n  type: z.literal('tool-call-result'),\n  toolCallId: z.string(),\n  result: z.unknown(),\n});\n\nexport const toolCallErrorEventSchema = z.object({\n  type: z.literal('tool-call-error'),\n  toolCallId: z.string(),\n  error: z.string(),\n});\n\nexport const resourceUpdateEventSchema = z.object({\n  type: z.literal('resource-update'),\n  name: z.string(),\n  value: z.unknown(),\n});\n\nexport const doneEventSchema = z.object({\n  type: z.literal('done'),\n  finishReason: finishReasonSchema,\n});\n\nexport const errorEventSchema = z.object({\n  type: z.literal('error'),\n  message: z.string(),\n  code: z.string().optional(),\n});\n\nexport const blockStartEventSchema = z.object({\n  type: z.literal('block-start'),\n  blockId: z.string(),\n  blockName: z.string(),\n  blockType: z.string(),\n  display: displayModeSchema,\n  description: z.string().optional(),\n  outputToChat: z.boolean().optional(),\n});\n\nexport const blockEndEventSchema = z.object({\n  type: z.literal('block-end'),\n  blockId: z.string(),\n  summary: z.string().optional(),\n});\n\nexport const thinkingStartEventSchema = z.object({\n  type: z.literal('thinking-start'),\n  id: z.string(),\n  thread: z.string().optional(),\n});\n\nexport const thinkingDeltaEventSchema = z.object({\n  type: z.literal('thinking-delta'),\n  content: z.string(),\n  thread: z.string().optional(),\n});\n\nexport const thinkingEndEventSchema = z.object({\n  type: z.literal('thinking-end'),\n  id: z.string(),\n});\n\nexport const pendingToolCallSchema = z.object({\n  toolCallId: z.string(),\n  toolName: z.string(),\n  args: z.record(z.string(), z.unknown()),\n  source: z.enum(['llm', 'block']).optional(),\n  outputVariable: z.string().optional(),\n  blockIndex: z.number().optional(),\n});\n\nexport const toolRequestEventSchema = z.object({\n  type: z.literal('tool-request'),\n  toolCalls: z.array(pendingToolCallSchema),\n});\n\n/**\n * Schema for tool result (consumer's response to tool-request)\n */\nexport const toolResultSchema = z.object({\n  toolCallId: z.string(),\n  toolName: z.string().optional(),\n  result: z.unknown().optional(),\n  error: z.string().optional(),\n  outputVariable: z.string().optional(),\n  blockIndex: z.number().optional(),\n});\n\n// Union of all stream events\nexport const streamEventSchema = z.discriminatedUnion('type', [\n  textDeltaEventSchema,\n  textStartEventSchema,\n  textEndEventSchema,\n  toolCallStartEventSchema,\n  toolCallArgsEventSchema,\n  toolCallResultEventSchema,\n  toolCallErrorEventSchema,\n  toolRequestEventSchema,\n  resourceUpdateEventSchema,\n  blockStartEventSchema,\n  blockEndEventSchema,\n  thinkingStartEventSchema,\n  thinkingDeltaEventSchema,\n  thinkingEndEventSchema,\n  doneEventSchema,\n  errorEventSchema,\n]);\n\n// Message types\nexport const messagePartTypeSchema = z.enum(['text', 'thinking', 'tool-call']);\n\nexport const messagePartSchema = z.object({\n  type: messagePartTypeSchema,\n  visible: z.boolean(),\n  content: z.string().optional(),\n  toolCall: toolCallInfoSchema.optional(),\n  thread: z.string().optional(),\n});\n\nexport const chatMessageSchema = z.object({\n  id: z.string(),\n  role: messageRoleSchema,\n  parts: z.array(messagePartSchema),\n  createdAt: z.string(),\n  visible: z.boolean().optional(),\n  content: z.string(),\n  toolCalls: z.array(toolCallInfoSchema).optional(),\n  reasoning: z.string().optional(),\n  reasoningSignature: z.string().optional(),\n});\n\nexport function safeParseStreamEvent(data: unknown) {\n  return streamEventSchema.safeParse(data);\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@octavus/core",
+  "version": "0.0.1",
+  "description": "Public types and utilities for Octavus client/server SDK communication",
+  "license": "MIT",
+  "author": "Octavus AI <hello@octavus.ai>",
+  "homepage": "https://octavus.dev",
+  "keywords": [
+    "octavus",
+    "ai",
+    "agents",
+    "sdk"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.6.3"
+  },
+  "dependencies": {
+    "zod": "^4.1.13"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src/ --max-warnings 0",
+    "lint:fix": "eslint src/ --max-warnings 0 --fix",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist .turbo"
+  }
+}