@kortix/sdk 0.9.102 → 0.9.103

package/dist/core/turns/parts.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Part-level helpers — type guards, attachment splitting, tool-part display
+ * info, and everything else that operates on a single part (or a single
+ * part's tool/path/diagnostics data) rather than a whole turn.
+ *
+ * Split out of `turns/index.ts` — see that file's history for the original
+ * single-file version. No React / DOM / framework imports allowed.
+ */
+import type { Diagnostic, MessageWithPartsLike, PartLike, RequestWithToolLike, ToolInfo, ToolPartLike } from './types.js';
+export declare function isTextPart<P extends PartLike>(part: P): part is P & {
+    type: 'text';
+};
+export declare function isReasoningPart<P extends PartLike>(part: P): part is P & {
+    type: 'reasoning';
+};
+export declare function isToolPart<P extends PartLike>(part: P): part is P & {
+    type: 'tool';
+};
+export declare function isFilePart<P extends PartLike>(part: P): part is P & {
+    type: 'file';
+};
+export declare function isAgentPart<P extends PartLike>(part: P): part is P & {
+    type: 'agent';
+};
+export declare function isCompactionPart<P extends PartLike>(part: P): part is P & {
+    type: 'compaction';
+};
+export declare function isSnapshotPart<P extends PartLike>(part: P): part is P & {
+    type: 'snapshot';
+};
+export declare function isPatchPart<P extends PartLike>(part: P): part is P & {
+    type: 'patch';
+};
+/** Get the text content from any part that has a `text` field. */
+export declare function getPartText(part: PartLike): string | undefined;
+/**
+ * Check if a file part is an image or PDF attachment.
+ * Matches SolidJS `isAttachment()` — session-turn.tsx:128
+ */
+export declare function isAttachment<P extends PartLike>(part: P): part is P & {
+    type: 'file';
+};
+/** Split user message parts into attachment parts and sticky (non-attachment) parts. */
+export declare function splitUserParts<P extends PartLike>(parts: readonly P[]): {
+    attachments: Array<P & {
+        type: 'file';
+    }>;
+    stickyParts: P[];
+};
+/** Tool part references to hide from the step list when permission/question is pending. */
+export interface HiddenToolRef {
+    messageID: string;
+    callID: string;
+}
+/**
+ * Get the list of tool parts to hide from the step list.
+ * Matches SolidJS session-turn.tsx:332-339
+ */
+export declare function getHiddenToolParts(permission: RequestWithToolLike | undefined, question: RequestWithToolLike | undefined): HiddenToolRef[];
+/** Check if a specific tool part should be hidden due to active permission/question. */
+export declare function isToolPartHidden(part: Pick<ToolPartLike, 'callID'>, messageId: string, hidden: HiddenToolRef[]): boolean;
+export declare function shouldShowToolPart(part: Pick<ToolPartLike, 'tool'>): boolean;
+/**
+ * Extract child session ID from a task tool part's metadata.
+ */
+export declare function getChildSessionId(part: Pick<ToolPartLike, 'tool' | 'state'>): string | undefined;
+/**
+ * Extract the error message from a child (sub-agent) session's raw messages.
+ *
+ * Mirrors `getTurnError` but operates over the flat `MessageWithParts` list
+ * returned by `useOpenCodeMessages`, so a parent thread can surface a sub-agent
+ * failure (e.g. "Free usage exceeded, subscribe to Go") that otherwise only
+ * lives on the child session and never reaches the parent's turn renderer.
+ * Scans newest-first so the most recent failure wins.
+ */
+export declare function getChildSessionError(childMessages: readonly MessageWithPartsLike[] | undefined): string | undefined;
+/**
+ * Collect all tool parts from a child session's assistant messages.
+ * Matches SolidJS getSessionToolParts — message-part.tsx:160-174
+ */
+export declare function getChildSessionToolParts<M extends MessageWithPartsLike>(childMessages: readonly M[]): Array<M['parts'][number] & {
+    type: 'tool';
+}>;
+/**
+ * Get icon, title, subtitle for a tool part.
+ * Matches SolidJS getToolInfo — message-part.tsx:184-270
+ *
+ * Icon names are Lucide icon names used by the React frontend.
+ */
+export declare function getToolInfo(tool: string, input?: Record<string, any>): ToolInfo;
+/** Extract filename from a path. */
+export declare function getFilename(path: string | undefined): string | undefined;
+/** Extract filename + parent directory, e.g. "main.go /workspace" */
+export declare function getFileWithDir(path: string | undefined): string | undefined;
+/** Extract directory from a path and strip trailing slash. */
+export declare function getDirectory(path: string | undefined): string | undefined;
+/** Strip the project root directory from paths for display. */
+export declare function relativizePath(path: string, projectDir?: string): string;
+/**
+ * One-line label for an agent/task card, with graceful fallbacks when the
+ * tool input has no description.
+ */
+export declare function getAgentCardLabel(input: Record<string, unknown>): string;
+/**
+ * Filter diagnostics for a file path, keeping only errors (severity=1), max 3.
+ * Matches SolidJS getDiagnostics — message-part.tsx:53-90
+ */
+export declare function getDiagnostics(diagnosticsByFile: Record<string, Diagnostic[]> | undefined, filePath: string | undefined): Diagnostic[];
+/** Get the permission request matching a specific tool part. */
+export declare function getPermissionForTool<T extends RequestWithToolLike>(permissions: readonly T[], callID: string): T | undefined;
+/** Get the question request matching a specific tool part. */
+export declare function getQuestionForTool<T extends RequestWithToolLike>(questions: readonly T[], callID: string): T | undefined;
+/** Strip ANSI escape codes from terminal output. */
+export declare function stripAnsi(str: string): string;
+//# sourceMappingURL=parts.d.ts.map

package/dist/core/turns/parts.d.ts.map

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