@guidemode/types 0.1.43

package/dist/esm/auth.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=auth.js.map

package/dist/esm/auth.js.map

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

package/dist/esm/canonical-validation.d.ts

@@ -0,0 +1,370 @@
+/**
+ * Canonical JSONL Format Validation
+ *
+ * Comprehensive Zod-based validation for canonical JSONL format.
+ * Supports tiered validation (critical errors vs warnings) and semantic checks.
+ */
+import { z } from 'zod';
+/**
+ * Union of all content block types
+ */
+declare const ContentBlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    text: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "text";
+    text: string;
+}, {
+    type: "text";
+    text: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"thinking">;
+    thinking: z.ZodOptional<z.ZodString>;
+    signature: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "thinking";
+    thinking?: string | undefined;
+    signature?: string | undefined;
+}, {
+    type: "thinking";
+    thinking?: string | undefined;
+    signature?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_use">;
+    id: z.ZodString;
+    name: z.ZodString;
+    input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    type: "tool_use";
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}, {
+    type: "tool_use";
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_result">;
+    tool_use_id: z.ZodString;
+    content: z.ZodString;
+    is_error: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    type: "tool_result";
+    tool_use_id: string;
+    content: string;
+    is_error?: boolean | undefined;
+}, {
+    type: "tool_result";
+    tool_use_id: string;
+    content: string;
+    is_error?: boolean | undefined;
+}>]>;
+/**
+ * Complete canonical message schema
+ *
+ * IMPORTANT: This validates the CANONICAL format (post-conversion)
+ * - Native Claude logs need filtering (remove file-history-snapshot, etc.)
+ * - All converters must add `provider` field
+ * - Only conversational messages (user, assistant, meta) are allowed
+ */
+export declare const CanonicalMessageSchema: z.ZodObject<{
+    uuid: z.ZodString;
+    timestamp: z.ZodEffects<z.ZodString, string, string>;
+    type: z.ZodEnum<["user", "assistant", "meta"]>;
+    sessionId: z.ZodString;
+    provider: z.ZodString;
+    message: z.ZodObject<{
+        role: z.ZodString;
+        content: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+            type: z.ZodLiteral<"text">;
+            text: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: "text";
+            text: string;
+        }, {
+            type: "text";
+            text: string;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"thinking">;
+            thinking: z.ZodOptional<z.ZodString>;
+            signature: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "thinking";
+            thinking?: string | undefined;
+            signature?: string | undefined;
+        }, {
+            type: "thinking";
+            thinking?: string | undefined;
+            signature?: string | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"tool_use">;
+            id: z.ZodString;
+            name: z.ZodString;
+            input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, "strip", z.ZodTypeAny, {
+            type: "tool_use";
+            id: string;
+            name: string;
+            input: Record<string, unknown>;
+        }, {
+            type: "tool_use";
+            id: string;
+            name: string;
+            input: Record<string, unknown>;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"tool_result">;
+            tool_use_id: z.ZodString;
+            content: z.ZodString;
+            is_error: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            type: "tool_result";
+            tool_use_id: string;
+            content: string;
+            is_error?: boolean | undefined;
+        }, {
+            type: "tool_result";
+            tool_use_id: string;
+            content: string;
+            is_error?: boolean | undefined;
+        }>]>, "many">]>;
+        model: z.ZodOptional<z.ZodString>;
+        usage: z.ZodOptional<z.ZodObject<{
+            input_tokens: z.ZodOptional<z.ZodNumber>;
+            output_tokens: z.ZodOptional<z.ZodNumber>;
+            cache_creation_input_tokens: z.ZodOptional<z.ZodNumber>;
+            cache_read_input_tokens: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            input_tokens?: number | undefined;
+            output_tokens?: number | undefined;
+            cache_creation_input_tokens?: number | undefined;
+            cache_read_input_tokens?: number | undefined;
+        }, {
+            input_tokens?: number | undefined;
+            output_tokens?: number | undefined;
+            cache_creation_input_tokens?: number | undefined;
+            cache_read_input_tokens?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        content: string | ({
+            type: "text";
+            text: string;
+        } | {
+            type: "thinking";
+            thinking?: string | undefined;
+            signature?: string | undefined;
+        } | {
+            type: "tool_use";
+            id: string;
+            name: string;
+            input: Record<string, unknown>;
+        } | {
+            type: "tool_result";
+            tool_use_id: string;
+            content: string;
+            is_error?: boolean | undefined;
+        })[];
+        role: string;
+        model?: string | undefined;
+        usage?: {
+            input_tokens?: number | undefined;
+            output_tokens?: number | undefined;
+            cache_creation_input_tokens?: number | undefined;
+            cache_read_input_tokens?: number | undefined;
+        } | undefined;
+    }, {
+        content: string | ({
+            type: "text";
+            text: string;
+        } | {
+            type: "thinking";
+            thinking?: string | undefined;
+            signature?: string | undefined;
+        } | {
+            type: "tool_use";
+            id: string;
+            name: string;
+            input: Record<string, unknown>;
+        } | {
+            type: "tool_result";
+            tool_use_id: string;
+            content: string;
+            is_error?: boolean | undefined;
+        })[];
+        role: string;
+        model?: string | undefined;
+        usage?: {
+            input_tokens?: number | undefined;
+            output_tokens?: number | undefined;
+            cache_creation_input_tokens?: number | undefined;
+            cache_read_input_tokens?: number | undefined;
+        } | undefined;
+    }>;
+    cwd: z.ZodOptional<z.ZodString>;
+    gitBranch: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    parentUuid: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    logicalParentUuid: z.ZodOptional<z.ZodString>;
+    isSidechain: z.ZodOptional<z.ZodBoolean>;
+    userType: z.ZodOptional<z.ZodString>;
+    providerMetadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    isMeta: z.ZodOptional<z.ZodBoolean>;
+    requestId: z.ZodOptional<z.ZodString>;
+    toolUseResult: z.ZodOptional<z.ZodUnknown>;
+    level: z.ZodOptional<z.ZodString>;
+    subtype: z.ZodOptional<z.ZodString>;
+    content: z.ZodOptional<z.ZodString>;
+    compactMetadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    toolUseID: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    message: {
+        content: string | ({
+            type: "text";
+            text: string;
+        } | {
+            type: "thinking";
+            thinking?: string | undefined;
+            signature?: string | undefined;
+        } | {
+            type: "tool_use";
+            id: string;
+            name: string;
+            input: Record<string, unknown>;
+        } | {
+            type: "tool_result";
+            tool_use_id: string;
+            content: string;
+            is_error?: boolean | undefined;
+        })[];
+        role: string;
+        model?: string | undefined;
+        usage?: {
+            input_tokens?: number | undefined;
+            output_tokens?: number | undefined;
+            cache_creation_input_tokens?: number | undefined;
+            cache_read_input_tokens?: number | undefined;
+        } | undefined;
+    };
+    type: "user" | "assistant" | "meta";
+    uuid: string;
+    timestamp: string;
+    sessionId: string;
+    provider: string;
+    content?: string | undefined;
+    cwd?: string | undefined;
+    gitBranch?: string | undefined;
+    version?: string | undefined;
+    parentUuid?: string | null | undefined;
+    logicalParentUuid?: string | undefined;
+    isSidechain?: boolean | undefined;
+    userType?: string | undefined;
+    providerMetadata?: Record<string, unknown> | undefined;
+    isMeta?: boolean | undefined;
+    requestId?: string | undefined;
+    toolUseResult?: unknown;
+    level?: string | undefined;
+    subtype?: string | undefined;
+    compactMetadata?: Record<string, unknown> | undefined;
+    toolUseID?: string | undefined;
+}, {
+    message: {
+        content: string | ({
+            type: "text";
+            text: string;
+        } | {
+            type: "thinking";
+            thinking?: string | undefined;
+            signature?: string | undefined;
+        } | {
+            type: "tool_use";
+            id: string;
+            name: string;
+            input: Record<string, unknown>;
+        } | {
+            type: "tool_result";
+            tool_use_id: string;
+            content: string;
+            is_error?: boolean | undefined;
+        })[];
+        role: string;
+        model?: string | undefined;
+        usage?: {
+            input_tokens?: number | undefined;
+            output_tokens?: number | undefined;
+            cache_creation_input_tokens?: number | undefined;
+            cache_read_input_tokens?: number | undefined;
+        } | undefined;
+    };
+    type: "user" | "assistant" | "meta";
+    uuid: string;
+    timestamp: string;
+    sessionId: string;
+    provider: string;
+    content?: string | undefined;
+    cwd?: string | undefined;
+    gitBranch?: string | undefined;
+    version?: string | undefined;
+    parentUuid?: string | null | undefined;
+    logicalParentUuid?: string | undefined;
+    isSidechain?: boolean | undefined;
+    userType?: string | undefined;
+    providerMetadata?: Record<string, unknown> | undefined;
+    isMeta?: boolean | undefined;
+    requestId?: string | undefined;
+    toolUseResult?: unknown;
+    level?: string | undefined;
+    subtype?: string | undefined;
+    compactMetadata?: Record<string, unknown> | undefined;
+    toolUseID?: string | undefined;
+}>;
+export type CanonicalMessage = z.infer<typeof CanonicalMessageSchema>;
+export type ContentBlock = z.infer<typeof ContentBlockSchema>;
+export type ValidationSeverity = 'error' | 'warning';
+export interface ValidationIssue {
+    severity: ValidationSeverity;
+    code: string;
+    message: string;
+    path?: string;
+    line?: number;
+    details?: unknown;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationIssue[];
+    warnings: ValidationIssue[];
+    messageCount: number;
+    validCount: number;
+}
+/**
+ * Validate a single canonical message
+ */
+export declare function validateCanonicalMessage(message: unknown, line?: number): ValidationResult;
+export interface SessionValidationResult extends ValidationResult {
+    sessionId: string;
+    provider: string | undefined;
+    startTime?: string;
+    endTime?: string;
+    duration?: number;
+    toolChainIssues: ValidationIssue[];
+}
+/**
+ * Validates tool use/result matching across a session
+ * IMPORTANT: tool_use can exist without tool_result (waiting for result)
+ * BUT tool_result MUST have a corresponding tool_use (no orphans)
+ */
+export declare function validateToolChain(messages: CanonicalMessage[]): ValidationIssue[];
+/**
+ * Validates UUID uniqueness across messages
+ * CRITICAL: Each message must have a unique UUID
+ */
+export declare function validateUUIDUniqueness(messages: CanonicalMessage[]): ValidationIssue[];
+/**
+ * Validates timestamp ordering across messages
+ */
+export declare function validateTimestampOrdering(messages: CanonicalMessage[]): ValidationIssue[];
+/**
+ * Validates a complete session (array of messages)
+ */
+export declare function validateSession(messages: CanonicalMessage[]): SessionValidationResult;
+export {};
+//# sourceMappingURL=canonical-validation.d.ts.map

package/dist/esm/canonical-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-validation.d.ts","sourceRoot":"","sources":["../../src/canonical-validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAsFvB;;GAEG;AACH,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAKtB,CAAA;AAiBF;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8BjC,CAAA;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AACrE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAM7D,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,CAAA;AAEpD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,eAAe,EAAE,CAAA;IACzB,QAAQ,EAAE,eAAe,EAAE,CAAA;IAC3B,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;CACnB;AAqPD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAuD1F;AAMD,MAAM,WAAW,uBAAwB,SAAQ,gBAAgB;IAC/D,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,eAAe,EAAE,eAAe,EAAE,CAAA;CACnC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,eAAe,EAAE,CA8EjF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,eAAe,EAAE,CA+BtF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,eAAe,EAAE,CAiDzF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,uBAAuB,CAoErF"}