attocode 0.1.0

package/dist/src/core/protocol/types.d.ts

@@ -0,0 +1,539 @@
+/**
+ * Op/Event Protocol Types
+ *
+ * Codex-inspired protocol layer for clean UI/agent separation.
+ * Operations flow from client to agent, Events flow from agent to client.
+ */
+import { z } from 'zod';
+import type { TokenUsage } from '../../types.js';
+/**
+ * Unique identifier for a submission (operation sent to agent).
+ */
+export type SubmissionId = string;
+/**
+ * Risk level for tool execution.
+ */
+export type RiskLevel = 'safe' | 'moderate' | 'dangerous';
+/**
+ * Attachment for user messages (images, files).
+ */
+export interface Attachment {
+    type: 'image' | 'file';
+    path?: string;
+    data?: string;
+    mimeType?: string;
+}
+/**
+ * User sends a message/turn to the agent.
+ */
+export interface OpUserTurn {
+    type: 'user_turn';
+    content: string;
+    attachments?: Attachment[];
+}
+/**
+ * User requests to interrupt the current operation.
+ */
+export interface OpInterrupt {
+    type: 'interrupt';
+    reason?: string;
+}
+/**
+ * User responds to an execution approval request.
+ */
+export interface OpExecApproval {
+    type: 'exec_approval';
+    toolCallId: string;
+    approved: boolean;
+    /** If true, auto-approve similar operations in this session */
+    persistent?: boolean;
+}
+/**
+ * User responds to a context compaction approval request.
+ */
+export interface OpCompactApproval {
+    type: 'compact_approval';
+    approved: boolean;
+    strategy?: 'summarize' | 'truncate' | 'hybrid';
+}
+/**
+ * User configures session settings.
+ */
+export interface OpConfigureSession {
+    type: 'configure_session';
+    config: {
+        model?: string;
+        maxIterations?: number;
+        autoCompact?: boolean;
+        approvalPolicy?: 'never' | 'on_request' | 'always';
+    };
+}
+/**
+ * User switches to a different session.
+ */
+export interface OpSwitchSession {
+    type: 'switch_session';
+    sessionId: string;
+}
+/**
+ * User forks the current session.
+ */
+export interface OpForkSession {
+    type: 'fork_session';
+    name?: string;
+}
+/**
+ * Union of all operation types.
+ */
+export type Operation = OpUserTurn | OpInterrupt | OpExecApproval | OpCompactApproval | OpConfigureSession | OpSwitchSession | OpForkSession;
+/**
+ * A submission wraps an operation with metadata.
+ */
+export interface Submission {
+    id: SubmissionId;
+    op: Operation;
+    timestamp: number;
+    /** Optional correlation ID for request/response tracking */
+    correlationId?: string;
+}
+/**
+ * Agent sends a message (streaming or complete).
+ */
+export interface EventAgentMessage {
+    type: 'agent_message';
+    content: string;
+    /** True when message is complete (no more chunks) */
+    done: boolean;
+    model?: string;
+}
+/**
+ * Agent requests approval to execute a tool.
+ */
+export interface EventExecApprovalRequest {
+    type: 'exec_approval_request';
+    toolCallId: string;
+    toolName: string;
+    toolArgs: Record<string, unknown>;
+    risk: RiskLevel;
+    description?: string;
+}
+/**
+ * Agent requests approval to compact context.
+ */
+export interface EventCompactApprovalRequest {
+    type: 'compact_approval_request';
+    currentTokens: number;
+    maxTokens: number;
+    proposedStrategy: 'summarize' | 'truncate' | 'hybrid';
+    estimatedTokensAfter: number;
+    summaryPreview?: string;
+}
+/**
+ * Agent signals task completion.
+ */
+export interface EventTaskComplete {
+    type: 'task_complete';
+    usage: TokenUsage;
+    status: 'success' | 'interrupted' | 'error';
+    durationMs: number;
+}
+/**
+ * Streaming output from tool execution (stdout/stderr).
+ */
+export interface EventExecOutput {
+    type: 'exec_output';
+    toolCallId: string;
+    stream: 'stdout' | 'stderr';
+    data: string;
+}
+/**
+ * Tool execution result.
+ */
+export interface EventToolResult {
+    type: 'tool_result';
+    toolCallId: string;
+    toolName: string;
+    result: unknown;
+    error?: string;
+    durationMs: number;
+}
+/**
+ * Error event.
+ */
+export interface EventError {
+    type: 'error';
+    code: string;
+    message: string;
+    recoverable: boolean;
+    stack?: string;
+}
+/**
+ * Token count update.
+ */
+export interface EventTokenCount {
+    type: 'token_count';
+    input: number;
+    output: number;
+    cached?: number;
+    total: number;
+}
+/**
+ * Session lifecycle events.
+ */
+export interface EventSession {
+    type: 'session';
+    action: 'created' | 'loaded' | 'switched' | 'forked' | 'compacted';
+    sessionId: string;
+    parentSessionId?: string;
+    name?: string;
+}
+/**
+ * Union of all event types.
+ */
+export type AgentEvent = EventAgentMessage | EventExecApprovalRequest | EventCompactApprovalRequest | EventTaskComplete | EventExecOutput | EventToolResult | EventError | EventTokenCount | EventSession;
+/**
+ * An event envelope wraps an event with metadata.
+ */
+export interface EventEnvelope {
+    submissionId: SubmissionId;
+    event: AgentEvent;
+    timestamp: number;
+}
+/**
+ * Schema for Attachment.
+ */
+export declare const AttachmentSchema: z.ZodObject<{
+    type: z.ZodEnum<["image", "file"]>;
+    path: z.ZodOptional<z.ZodString>;
+    data: z.ZodOptional<z.ZodString>;
+    mimeType: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "file" | "image";
+    path?: string | undefined;
+    data?: string | undefined;
+    mimeType?: string | undefined;
+}, {
+    type: "file" | "image";
+    path?: string | undefined;
+    data?: string | undefined;
+    mimeType?: string | undefined;
+}>;
+/**
+ * Schema for OpUserTurn - content must be non-empty.
+ */
+export declare const OpUserTurnSchema: z.ZodObject<{
+    type: z.ZodLiteral<"user_turn">;
+    content: z.ZodString;
+    attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<["image", "file"]>;
+        path: z.ZodOptional<z.ZodString>;
+        data: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "file" | "image";
+        path?: string | undefined;
+        data?: string | undefined;
+        mimeType?: string | undefined;
+    }, {
+        type: "file" | "image";
+        path?: string | undefined;
+        data?: string | undefined;
+        mimeType?: string | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    type: "user_turn";
+    content: string;
+    attachments?: {
+        type: "file" | "image";
+        path?: string | undefined;
+        data?: string | undefined;
+        mimeType?: string | undefined;
+    }[] | undefined;
+}, {
+    type: "user_turn";
+    content: string;
+    attachments?: {
+        type: "file" | "image";
+        path?: string | undefined;
+        data?: string | undefined;
+        mimeType?: string | undefined;
+    }[] | undefined;
+}>;
+/**
+ * Schema for OpInterrupt.
+ */
+export declare const OpInterruptSchema: z.ZodObject<{
+    type: z.ZodLiteral<"interrupt">;
+    reason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "interrupt";
+    reason?: string | undefined;
+}, {
+    type: "interrupt";
+    reason?: string | undefined;
+}>;
+/**
+ * Schema for OpExecApproval.
+ */
+export declare const OpExecApprovalSchema: z.ZodObject<{
+    type: z.ZodLiteral<"exec_approval">;
+    toolCallId: z.ZodString;
+    approved: z.ZodBoolean;
+    persistent: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    type: "exec_approval";
+    approved: boolean;
+    toolCallId: string;
+    persistent?: boolean | undefined;
+}, {
+    type: "exec_approval";
+    approved: boolean;
+    toolCallId: string;
+    persistent?: boolean | undefined;
+}>;
+/**
+ * Schema for OpCompactApproval.
+ */
+export declare const OpCompactApprovalSchema: z.ZodObject<{
+    type: z.ZodLiteral<"compact_approval">;
+    approved: z.ZodBoolean;
+    strategy: z.ZodOptional<z.ZodEnum<["summarize", "truncate", "hybrid"]>>;
+}, "strip", z.ZodTypeAny, {
+    type: "compact_approval";
+    approved: boolean;
+    strategy?: "hybrid" | "truncate" | "summarize" | undefined;
+}, {
+    type: "compact_approval";
+    approved: boolean;
+    strategy?: "hybrid" | "truncate" | "summarize" | undefined;
+}>;
+/**
+ * Schema for OpConfigureSession.
+ */
+export declare const OpConfigureSessionSchema: z.ZodObject<{
+    type: z.ZodLiteral<"configure_session">;
+    config: z.ZodObject<{
+        model: z.ZodOptional<z.ZodString>;
+        maxIterations: z.ZodOptional<z.ZodNumber>;
+        autoCompact: z.ZodOptional<z.ZodBoolean>;
+        approvalPolicy: z.ZodOptional<z.ZodEnum<["never", "on_request", "always"]>>;
+    }, "strip", z.ZodTypeAny, {
+        model?: string | undefined;
+        maxIterations?: number | undefined;
+        autoCompact?: boolean | undefined;
+        approvalPolicy?: "always" | "never" | "on_request" | undefined;
+    }, {
+        model?: string | undefined;
+        maxIterations?: number | undefined;
+        autoCompact?: boolean | undefined;
+        approvalPolicy?: "always" | "never" | "on_request" | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    type: "configure_session";
+    config: {
+        model?: string | undefined;
+        maxIterations?: number | undefined;
+        autoCompact?: boolean | undefined;
+        approvalPolicy?: "always" | "never" | "on_request" | undefined;
+    };
+}, {
+    type: "configure_session";
+    config: {
+        model?: string | undefined;
+        maxIterations?: number | undefined;
+        autoCompact?: boolean | undefined;
+        approvalPolicy?: "always" | "never" | "on_request" | undefined;
+    };
+}>;
+/**
+ * Schema for OpSwitchSession.
+ */
+export declare const OpSwitchSessionSchema: z.ZodObject<{
+    type: z.ZodLiteral<"switch_session">;
+    sessionId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "switch_session";
+    sessionId: string;
+}, {
+    type: "switch_session";
+    sessionId: string;
+}>;
+/**
+ * Schema for OpForkSession.
+ */
+export declare const OpForkSessionSchema: z.ZodObject<{
+    type: z.ZodLiteral<"fork_session">;
+    name: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "fork_session";
+    name?: string | undefined;
+}, {
+    type: "fork_session";
+    name?: string | undefined;
+}>;
+/**
+ * Discriminated union schema for all operations.
+ */
+export declare const OperationSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"user_turn">;
+    content: z.ZodString;
+    attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<["image", "file"]>;
+        path: z.ZodOptional<z.ZodString>;
+        data: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "file" | "image";
+        path?: string | undefined;
+        data?: string | undefined;
+        mimeType?: string | undefined;
+    }, {
+        type: "file" | "image";
+        path?: string | undefined;
+        data?: string | undefined;
+        mimeType?: string | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    type: "user_turn";
+    content: string;
+    attachments?: {
+        type: "file" | "image";
+        path?: string | undefined;
+        data?: string | undefined;
+        mimeType?: string | undefined;
+    }[] | undefined;
+}, {
+    type: "user_turn";
+    content: string;
+    attachments?: {
+        type: "file" | "image";
+        path?: string | undefined;
+        data?: string | undefined;
+        mimeType?: string | undefined;
+    }[] | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"interrupt">;
+    reason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "interrupt";
+    reason?: string | undefined;
+}, {
+    type: "interrupt";
+    reason?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"exec_approval">;
+    toolCallId: z.ZodString;
+    approved: z.ZodBoolean;
+    persistent: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    type: "exec_approval";
+    approved: boolean;
+    toolCallId: string;
+    persistent?: boolean | undefined;
+}, {
+    type: "exec_approval";
+    approved: boolean;
+    toolCallId: string;
+    persistent?: boolean | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"compact_approval">;
+    approved: z.ZodBoolean;
+    strategy: z.ZodOptional<z.ZodEnum<["summarize", "truncate", "hybrid"]>>;
+}, "strip", z.ZodTypeAny, {
+    type: "compact_approval";
+    approved: boolean;
+    strategy?: "hybrid" | "truncate" | "summarize" | undefined;
+}, {
+    type: "compact_approval";
+    approved: boolean;
+    strategy?: "hybrid" | "truncate" | "summarize" | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"configure_session">;
+    config: z.ZodObject<{
+        model: z.ZodOptional<z.ZodString>;
+        maxIterations: z.ZodOptional<z.ZodNumber>;
+        autoCompact: z.ZodOptional<z.ZodBoolean>;
+        approvalPolicy: z.ZodOptional<z.ZodEnum<["never", "on_request", "always"]>>;
+    }, "strip", z.ZodTypeAny, {
+        model?: string | undefined;
+        maxIterations?: number | undefined;
+        autoCompact?: boolean | undefined;
+        approvalPolicy?: "always" | "never" | "on_request" | undefined;
+    }, {
+        model?: string | undefined;
+        maxIterations?: number | undefined;
+        autoCompact?: boolean | undefined;
+        approvalPolicy?: "always" | "never" | "on_request" | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    type: "configure_session";
+    config: {
+        model?: string | undefined;
+        maxIterations?: number | undefined;
+        autoCompact?: boolean | undefined;
+        approvalPolicy?: "always" | "never" | "on_request" | undefined;
+    };
+}, {
+    type: "configure_session";
+    config: {
+        model?: string | undefined;
+        maxIterations?: number | undefined;
+        autoCompact?: boolean | undefined;
+        approvalPolicy?: "always" | "never" | "on_request" | undefined;
+    };
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"switch_session">;
+    sessionId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "switch_session";
+    sessionId: string;
+}, {
+    type: "switch_session";
+    sessionId: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"fork_session">;
+    name: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "fork_session";
+    name?: string | undefined;
+}, {
+    type: "fork_session";
+    name?: string | undefined;
+}>]>;
+/**
+ * Type guard for OpUserTurn.
+ */
+export declare function isUserTurn(op: Operation): op is OpUserTurn;
+/**
+ * Type guard for OpInterrupt.
+ */
+export declare function isInterrupt(op: Operation): op is OpInterrupt;
+/**
+ * Type guard for OpExecApproval.
+ */
+export declare function isExecApproval(op: Operation): op is OpExecApproval;
+/**
+ * Type guard for OpCompactApproval.
+ */
+export declare function isCompactApproval(op: Operation): op is OpCompactApproval;
+/**
+ * Type guard for EventAgentMessage.
+ */
+export declare function isAgentMessage(event: AgentEvent): event is EventAgentMessage;
+/**
+ * Type guard for EventExecApprovalRequest.
+ */
+export declare function isExecApprovalRequest(event: AgentEvent): event is EventExecApprovalRequest;
+/**
+ * Type guard for EventCompactApprovalRequest.
+ */
+export declare function isCompactApprovalRequest(event: AgentEvent): event is EventCompactApprovalRequest;
+/**
+ * Type guard for EventTaskComplete.
+ */
+export declare function isTaskComplete(event: AgentEvent): event is EventTaskComplete;
+/**
+ * Type guard for EventError.
+ */
+export declare function isError(event: AgentEvent): event is EventError;
+//# sourceMappingURL=types.d.ts.map

package/dist/src/core/protocol/types.d.ts.map

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

package/dist/src/core/protocol/types.js

@@ -0,0 +1,149 @@
+/**
+ * Op/Event Protocol Types
+ *
+ * Codex-inspired protocol layer for clean UI/agent separation.
+ * Operations flow from client to agent, Events flow from agent to client.
+ */
+import { z } from 'zod';
+// =============================================================================
+// ZOD SCHEMAS (Runtime Validation)
+// =============================================================================
+/**
+ * Schema for Attachment.
+ */
+export const AttachmentSchema = z.object({
+    type: z.enum(['image', 'file']),
+    path: z.string().optional(),
+    data: z.string().optional(),
+    mimeType: z.string().optional(),
+});
+/**
+ * Schema for OpUserTurn - content must be non-empty.
+ */
+export const OpUserTurnSchema = z.object({
+    type: z.literal('user_turn'),
+    content: z.string().min(1, 'Content must not be empty'),
+    attachments: z.array(AttachmentSchema).optional(),
+});
+/**
+ * Schema for OpInterrupt.
+ */
+export const OpInterruptSchema = z.object({
+    type: z.literal('interrupt'),
+    reason: z.string().optional(),
+});
+/**
+ * Schema for OpExecApproval.
+ */
+export const OpExecApprovalSchema = z.object({
+    type: z.literal('exec_approval'),
+    toolCallId: z.string(),
+    approved: z.boolean(),
+    persistent: z.boolean().optional(),
+});
+/**
+ * Schema for OpCompactApproval.
+ */
+export const OpCompactApprovalSchema = z.object({
+    type: z.literal('compact_approval'),
+    approved: z.boolean(),
+    strategy: z.enum(['summarize', 'truncate', 'hybrid']).optional(),
+});
+/**
+ * Schema for OpConfigureSession.
+ */
+export const OpConfigureSessionSchema = z.object({
+    type: z.literal('configure_session'),
+    config: z.object({
+        model: z.string().optional(),
+        maxIterations: z.number().int().positive().optional(),
+        autoCompact: z.boolean().optional(),
+        approvalPolicy: z.enum(['never', 'on_request', 'always']).optional(),
+    }),
+});
+/**
+ * Schema for OpSwitchSession.
+ */
+export const OpSwitchSessionSchema = z.object({
+    type: z.literal('switch_session'),
+    sessionId: z.string(),
+});
+/**
+ * Schema for OpForkSession.
+ */
+export const OpForkSessionSchema = z.object({
+    type: z.literal('fork_session'),
+    name: z.string().optional(),
+});
+/**
+ * Discriminated union schema for all operations.
+ */
+export const OperationSchema = z.discriminatedUnion('type', [
+    OpUserTurnSchema,
+    OpInterruptSchema,
+    OpExecApprovalSchema,
+    OpCompactApprovalSchema,
+    OpConfigureSessionSchema,
+    OpSwitchSessionSchema,
+    OpForkSessionSchema,
+]);
+// =============================================================================
+// TYPE GUARDS
+// =============================================================================
+// Operation type guards
+/**
+ * Type guard for OpUserTurn.
+ */
+export function isUserTurn(op) {
+    return op.type === 'user_turn';
+}
+/**
+ * Type guard for OpInterrupt.
+ */
+export function isInterrupt(op) {
+    return op.type === 'interrupt';
+}
+/**
+ * Type guard for OpExecApproval.
+ */
+export function isExecApproval(op) {
+    return op.type === 'exec_approval';
+}
+/**
+ * Type guard for OpCompactApproval.
+ */
+export function isCompactApproval(op) {
+    return op.type === 'compact_approval';
+}
+// Event type guards
+/**
+ * Type guard for EventAgentMessage.
+ */
+export function isAgentMessage(event) {
+    return event.type === 'agent_message';
+}
+/**
+ * Type guard for EventExecApprovalRequest.
+ */
+export function isExecApprovalRequest(event) {
+    return event.type === 'exec_approval_request';
+}
+/**
+ * Type guard for EventCompactApprovalRequest.
+ */
+export function isCompactApprovalRequest(event) {
+    return event.type === 'compact_approval_request';
+}
+/**
+ * Type guard for EventTaskComplete.
+ */
+export function isTaskComplete(event) {
+    return event.type === 'task_complete';
+}
+/**
+ * Type guard for EventError.
+ */
+export function isError(event) {
+    return event.type === 'error';
+}
+//# sourceMappingURL=types.js.map

package/dist/src/core/protocol/types.js.map

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