@kooka/core 0.1.0

package/dist/types/backgroundJobs.d.ts

@@ -0,0 +1,33 @@
+export declare const DEFAULT_BACKGROUND_TTL_MS: number;
+export declare const DEFAULT_BACKGROUND_KILL_GRACE_MS = 1500;
+export type BackgroundJob = {
+    id: string;
+    scope: string;
+    key: string;
+    command: string;
+    cwd: string;
+    pid: number;
+    createdAt: number;
+    ttlMs: number;
+    expiresAt: number;
+};
+export declare function createBackgroundJobKey(args: {
+    cwd: string;
+    command: string;
+}): string;
+export declare function isPidAlive(pid: number): boolean;
+export declare function killProcessTree(pid: number, signal: NodeJS.Signals): void;
+export declare function getBackgroundJob(scope: string, key: string): BackgroundJob | undefined;
+export declare function listBackgroundJobs(scope?: string): BackgroundJob[];
+export declare function removeBackgroundJob(scope: string, key: string): void;
+export declare function refreshBackgroundJob(scope: string, key: string, ttlMs?: number): BackgroundJob | undefined;
+export declare function registerBackgroundJob(args: {
+    scope: string;
+    key: string;
+    command: string;
+    cwd: string;
+    pid: number;
+    ttlMs: number;
+}): BackgroundJob;
+export declare function cleanupDeadBackgroundJobs(scope?: string): void;
+//# sourceMappingURL=backgroundJobs.d.ts.map

package/dist/types/backgroundJobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backgroundJobs.d.ts","sourceRoot":"","sources":["../../src/backgroundJobs.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,yBAAyB,QAAiB,CAAC;AACxD,eAAO,MAAM,gCAAgC,OAAO,CAAC;AAErD,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAaF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAIrF;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAU/C;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAqBzE;AAkCD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAItF;AAED,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE,CAYlE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAUpE;AAyBD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAmB1G;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,aAAa,CAqChB;AAED,wBAAgB,yBAAyB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAW9D"}

package/dist/types/compaction.d.ts

@@ -0,0 +1,35 @@
+import type { AgentHistoryMessage, AgentHistoryMetadata } from './history';
+export type ModelLimit = {
+    context: number;
+    output?: number;
+};
+export type CompactionConfig = {
+    auto: boolean;
+    prune: boolean;
+    pruneProtectTokens: number;
+    pruneMinimumTokens: number;
+};
+export declare const COMPACTION_MARKER_TEXT = "What did we do so far?";
+export declare const COMPACTION_PROMPT_TEXT = "Provide a detailed prompt for continuing our conversation above. Focus on information that would be helpful for continuing the conversation, including what we did, what we are doing, which files we are working on, and what we should do next. Assume a new session will not have access to the previous conversation.";
+export declare const COMPACTION_AUTO_CONTINUE_TEXT = "Continue if you have next steps.";
+export declare const COMPACTED_TOOL_PLACEHOLDER = "[Old tool result content cleared]";
+export declare const COMPACTION_SYSTEM_PROMPT: string;
+export declare function getReservedOutputTokens(params: {
+    modelLimit?: ModelLimit;
+    maxOutputTokens: number;
+}): number;
+export declare function extractUsageTokens(usage: unknown): AgentHistoryMetadata['tokens'] | undefined;
+export declare function getEffectiveHistory(history: AgentHistoryMessage[]): AgentHistoryMessage[];
+export declare function markPrunableToolOutputs(history: AgentHistoryMessage[], config: CompactionConfig): {
+    totalToolOutputTokens: number;
+    prunedTokens: number;
+    markedParts: number;
+};
+export declare function createHistoryForModel(history: AgentHistoryMessage[]): AgentHistoryMessage[];
+export declare function isOverflow(params: {
+    lastTokens: AgentHistoryMetadata['tokens'] | undefined;
+    modelLimit: ModelLimit | undefined;
+    reservedOutputTokens: number;
+    config: CompactionConfig;
+}): boolean;
+//# sourceMappingURL=compaction.d.ts.map

package/dist/types/compaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../src/compaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAE3E,MAAM,MAAM,UAAU,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAE/D,eAAO,MAAM,sBAAsB,8TAC0R,CAAC;AAE9T,eAAO,MAAM,6BAA6B,qCAAqC,CAAC;AAEhF,eAAO,MAAM,0BAA0B,sCAAsC,CAAC;AAE9E,eAAO,MAAM,wBAAwB,QAU0E,CAAC;AAMhH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAAE,UAAU,CAAC,EAAE,UAAU,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAO5G;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,CAAC,QAAQ,CAAC,GAAG,SAAS,CAoD7F;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,EAAE,GAAG,mBAAmB,EAAE,CAazF;AAoCD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,mBAAmB,EAAE,EAAE,MAAM,EAAE,gBAAgB,GAAG;IACjG,qBAAqB,EAAE,MAAM,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB,CAgDA;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,mBAAmB,EAAE,GAAG,mBAAmB,EAAE,CA6B3F;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE;IACjC,UAAU,EAAE,oBAAoB,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC;IACvD,UAAU,EAAE,UAAU,GAAG,SAAS,CAAC;IACnC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,MAAM,EAAE,gBAAgB,CAAC;CAC1B,GAAG,OAAO,CAYV"}

package/dist/types/fsPath.d.ts

@@ -0,0 +1,4 @@
+export declare function normalizeFsPath(value: string): string;
+export declare function isSubPath(childPath: string, parentPath: string): boolean;
+export declare function expandHome(p: string): string;
+//# sourceMappingURL=fsPath.d.ts.map

package/dist/types/fsPath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fsPath.d.ts","sourceRoot":"","sources":["../../src/fsPath.ts"],"names":[],"mappings":"AAGA,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAIxE;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ5C"}

package/dist/types/history.d.ts

@@ -0,0 +1,48 @@
+import type { DynamicToolUIPart, UIMessage } from 'ai';
+export type AgentHistoryMetadata = {
+    mode?: 'build' | 'plan';
+    finishReason?: string;
+    synthetic?: boolean;
+    summary?: boolean;
+    compaction?: {
+        auto: boolean;
+    };
+    tokens?: {
+        input?: number;
+        output?: number;
+        cacheRead?: number;
+        cacheWrite?: number;
+        total?: number;
+        raw?: unknown;
+    };
+};
+export type AgentHistoryMessage = UIMessage<AgentHistoryMetadata>;
+export declare function createUserHistoryMessage(text: string, options?: {
+    synthetic?: boolean;
+    compaction?: {
+        auto: boolean;
+    };
+}): AgentHistoryMessage;
+export declare function createAssistantHistoryMessage(): AgentHistoryMessage;
+export declare function getMessageText(message: AgentHistoryMessage): string;
+export declare function appendText(message: AgentHistoryMessage, delta: string): void;
+export declare function appendReasoning(message: AgentHistoryMessage, delta: string): void;
+export declare function upsertDynamicToolCall(message: AgentHistoryMessage, params: {
+    toolName: string;
+    toolCallId: string;
+    input: unknown;
+}): DynamicToolUIPart;
+export declare function setDynamicToolOutput(message: AgentHistoryMessage, params: {
+    toolName: string;
+    toolCallId: string;
+    input: unknown;
+    output: unknown;
+}): void;
+export declare function setDynamicToolError(message: AgentHistoryMessage, params: {
+    toolName: string;
+    toolCallId: string;
+    input: unknown;
+    errorText: string;
+}): void;
+export declare function finalizeStreamingParts(message: AgentHistoryMessage): void;
+//# sourceMappingURL=history.d.ts.map

package/dist/types/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAA+B,SAAS,EAAE,MAAM,IAAI,CAAC;AAEpF,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC;IAC/B,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,OAAO,CAAC;KACf,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,SAAS,CAAC,oBAAoB,CAAC,CAAC;AAElE,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GAChE,mBAAmB,CAiBrB;AAED,wBAAgB,6BAA6B,IAAI,mBAAmB,CAMnE;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAKnE;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAW5E;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAWjF;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,mBAAmB,EAC5B,MAAM,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC/D,iBAAiB,CAuBnB;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,mBAAmB,EAC5B,MAAM,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAChF,IAAI,CAUN;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,mBAAmB,EAC5B,MAAM,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAClF,IAAI,CAUN;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAQzE"}

package/dist/types/index.d.ts

@@ -0,0 +1,14 @@
+export type { ToolParameterSchema } from './toolSchema';
+export { expandHome, isSubPath, normalizeFsPath } from './fsPath';
+export type { PermissionAction, PermissionRule, PermissionRuleset } from './permission';
+export { evaluatePermission, mergeRulesets, wildcardMatch } from './permission';
+export { findExternalPathReferencesInShellCommand, isPathInsideWorkspace } from './shellPaths';
+export type { ValidationResult, ShellCommandDecision } from './validation';
+export { evaluateShellCommand, optionalBoolean, optionalNumber, optionalString, requireString, validateToolArgs, } from './validation';
+export type { BackgroundJob } from './backgroundJobs';
+export { DEFAULT_BACKGROUND_KILL_GRACE_MS, DEFAULT_BACKGROUND_TTL_MS, cleanupDeadBackgroundJobs, createBackgroundJobKey, getBackgroundJob, isPidAlive, killProcessTree, listBackgroundJobs, refreshBackgroundJob, registerBackgroundJob, removeBackgroundJob, } from './backgroundJobs';
+export type { AgentHistoryMessage, AgentHistoryMetadata } from './history';
+export { appendReasoning, appendText, createAssistantHistoryMessage, createUserHistoryMessage, finalizeStreamingParts, getMessageText, setDynamicToolError, setDynamicToolOutput, upsertDynamicToolCall, } from './history';
+export type { CompactionConfig, ModelLimit } from './compaction';
+export { COMPACTED_TOOL_PLACEHOLDER, COMPACTION_AUTO_CONTINUE_TEXT, COMPACTION_MARKER_TEXT, COMPACTION_PROMPT_TEXT, COMPACTION_SYSTEM_PROMPT, createHistoryForModel, extractUsageTokens, getEffectiveHistory, getReservedOutputTokens, isOverflow, markPrunableToolOutputs, } from './compaction';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAElE,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACxF,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAEhF,OAAO,EAAE,wCAAwC,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAE/F,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,cAAc,EACd,aAAa,EACb,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAEtB,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EACL,gCAAgC,EAChC,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,EACtB,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAC3E,OAAO,EACL,eAAe,EACf,UAAU,EACV,6BAA6B,EAC7B,wBAAwB,EACxB,sBAAsB,EACtB,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,WAAW,CAAC;AAEnB,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EACL,0BAA0B,EAC1B,6BAA6B,EAC7B,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,UAAU,EACV,uBAAuB,GACxB,MAAM,cAAc,CAAC"}

package/dist/types/permission.d.ts

@@ -0,0 +1,11 @@
+export type PermissionAction = 'allow' | 'ask' | 'deny';
+export type PermissionRule = {
+    permission: string;
+    pattern: string;
+    action: PermissionAction;
+};
+export type PermissionRuleset = PermissionRule[];
+export declare function wildcardMatch(pattern: string, value: string): boolean;
+export declare function evaluatePermission(permission: string, pattern: string, ruleset: PermissionRuleset): PermissionRule | undefined;
+export declare function mergeRulesets(...rulesets: Array<PermissionRuleset | undefined>): PermissionRuleset;
+//# sourceMappingURL=permission.d.ts.map

package/dist/types/permission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission.d.ts","sourceRoot":"","sources":["../../src/permission.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AAExD,MAAM,MAAM,cAAc,GAAG;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,gBAAgB,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,cAAc,EAAE,CAAC;AAwBjD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAMrE;AAED,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,iBAAiB,GACzB,cAAc,GAAG,SAAS,CAQ5B;AAED,wBAAgB,aAAa,CAAC,GAAG,QAAQ,EAAE,KAAK,CAAC,iBAAiB,GAAG,SAAS,CAAC,GAAG,iBAAiB,CAOlG"}

package/dist/types/shellPaths.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Best-effort detection of file-system path references in a shell command.
+ * Used to enforce "no external paths" without blocking all shell usage.
+ *
+ * This is not a sandbox; it only aims to catch explicit path references like:
+ * - absolute paths: /etc/passwd, C:\Windows\system.ini
+ * - parent traversal that resolves outside workspace: ../outside.txt
+ * - home paths: ~/.ssh/id_rsa
+ */
+export declare function findExternalPathReferencesInShellCommand(command: string, options: {
+    cwd: string;
+    workspaceRoot: string;
+}): string[];
+export declare function isPathInsideWorkspace(targetPath: string, workspaceRoot: string): boolean;
+//# sourceMappingURL=shellPaths.d.ts.map

package/dist/types/shellPaths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shellPaths.d.ts","sourceRoot":"","sources":["../../src/shellPaths.ts"],"names":[],"mappings":"AAkGA;;;;;;;;GAQG;AACH,wBAAgB,wCAAwC,CACtD,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAC9C,MAAM,EAAE,CAyCV;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAMxF"}

package/dist/types/toolSchema.d.ts

@@ -0,0 +1,10 @@
+export interface ToolParameterSchema {
+    type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+    description?: string;
+    enum?: string[];
+    items?: ToolParameterSchema;
+    properties?: Record<string, ToolParameterSchema>;
+    required?: string[];
+    default?: unknown;
+}
+//# sourceMappingURL=toolSchema.d.ts.map

package/dist/types/toolSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolSchema.d.ts","sourceRoot":"","sources":["../../src/toolSchema.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACjD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/dist/types/validation.d.ts

@@ -0,0 +1,29 @@
+import type { ToolParameterSchema } from './toolSchema';
+export interface ValidationResult<T = Record<string, unknown>> {
+    valid: boolean;
+    errors: string[];
+    data: T;
+}
+export declare function validateToolArgs(args: Record<string, unknown>, schema: {
+    properties: Record<string, ToolParameterSchema>;
+    required?: string[];
+}): ValidationResult;
+export declare function requireString(args: Record<string, unknown>, field: string): {
+    value: string;
+} | {
+    error: string;
+};
+export declare function optionalString(args: Record<string, unknown>, field: string, defaultValue?: string): string | undefined;
+export declare function optionalNumber(args: Record<string, unknown>, field: string, defaultValue?: number): number | undefined;
+export declare function optionalBoolean(args: Record<string, unknown>, field: string, defaultValue?: boolean): boolean | undefined;
+export type ShellCommandDecision = {
+    verdict: 'allow';
+} | {
+    verdict: 'needs_approval';
+    reason: string;
+} | {
+    verdict: 'deny';
+    reason: string;
+};
+export declare function evaluateShellCommand(command: string): ShellCommandDecision;
+//# sourceMappingURL=validation.d.ts.map

package/dist/types/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3D,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,EAAE,CAAC,CAAC;CACT;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE;IACN,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAChD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,GACA,gBAAgB,CAiClB;AAmFD,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,MAAM,GACZ;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAMvC;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMtH;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAetH;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,OAAO,GACrB,OAAO,GAAG,SAAS,CAcrB;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GACpB;IAAE,OAAO,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAkExC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,CAsB1E"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@kooka/core",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Shared LingYun core library (runtime-agnostic agent primitives).",
+  "license": "Apache-2.0",
+  "main": "./dist/cjs/index.cjs",
+  "types": "./dist/types/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "ai": "^6.0.6"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.16",
+    "esbuild": "^0.25.0",
+    "typescript": "^5.3.3"
+  },
+  "scripts": {
+    "clean": "node -e \"require('fs').rmSync('dist', { recursive: true, force: true })\"",
+    "build:types": "tsc -p tsconfig.json",
+    "build:esm": "esbuild src/index.ts --bundle --platform=node --target=es2022 --format=esm --outfile=dist/esm/index.js",
+    "build:cjs": "esbuild src/index.ts --bundle --platform=node --target=es2022 --format=cjs --outfile=dist/cjs/index.cjs",
+    "build": "pnpm run clean && pnpm run build:types && pnpm run build:esm && pnpm run build:cjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}