@kruntime/komputer 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,462 @@
+import type { AgentSession } from './agent-session.js';
+import type { ShellExecutionLimits } from './remote.js';
+import type { KFileSystem } from './vfs.js';
+export type Json = null | boolean | number | string | Json[] | {
+    [key: string]: Json;
+};
+export type ModeName = 'normal' | 'readonly' | 'plan' | 'limited';
+export interface AccessScope {
+    fs?: string[];
+    commands?: string[];
+    shellCommands?: string[];
+    tools?: string[];
+    models?: string[];
+    hosts?: string[];
+    secrets?: string[];
+}
+export interface ModeState {
+    name: ModeName;
+    scope?: AccessScope;
+}
+export interface AgentDefinition {
+    home?: string;
+    model?: string;
+}
+export interface RuntimeImage {
+    schema?: string;
+    digest?: string;
+    agents?: Record<string, AgentDefinition>;
+    files?: Record<string, string | Json>;
+    logins?: Record<string, RuntimeLogin>;
+    models?: Record<string, unknown>;
+    needs?: Record<string, unknown>;
+    commands?: Record<string, RuntimeCommand>;
+    hooks?: RuntimeHook[];
+    crons?: RuntimeCron[];
+    sourceDir?: string;
+}
+export interface NetworkRequest {
+    url: string;
+    method: string;
+    headers: Record<string, string>;
+    body?: string;
+    host: string;
+    path: string;
+}
+export interface NetworkResponse {
+    status?: number;
+    headers?: Record<string, string>;
+    body?: string | Uint8Array | Json;
+}
+export type NetworkHost = string | Record<string, string | Json> | {
+    url?: string;
+    files?: Record<string, string | Json>;
+    fetch?: (request: NetworkRequest) => Promise<NetworkResponse> | NetworkResponse;
+} | ((request: NetworkRequest) => Promise<NetworkResponse> | NetworkResponse);
+export interface NormalizedRuntimeImage extends RuntimeImage {
+    schema: 'k.image.v1';
+    digest: string;
+    agents: Record<string, AgentDefinition>;
+    files: Record<string, string | Json>;
+    logins: Record<string, RuntimeLogin>;
+    models: Record<string, unknown>;
+    needs: Record<string, unknown>;
+    commands: Record<string, RuntimeCommand>;
+    hooks: RuntimeHook[];
+    crons: RuntimeCron[];
+}
+export interface RuntimeLoginContext {
+    firstLogin: boolean;
+    recovered: boolean;
+}
+export type RuntimeLogin = (agent: AgentSession, ctx: RuntimeLoginContext) => Promise<void> | void;
+export interface RuntimeShellPath {
+    get(): string;
+    set(value: string): void;
+    prepend(path: string): void;
+    append(path: string): void;
+}
+export interface RuntimeShellFace {
+    cd(path: string): Promise<void>;
+    path: RuntimeShellPath;
+}
+export interface RuntimeEnvFace {
+    get(name?: string): Record<string, string> | string | undefined;
+    set(name: string, value: string): void;
+    unset(name: string): void;
+}
+export interface ExecInput {
+    command: string;
+    argv?: string[];
+    stdin?: string;
+    remote?: string;
+    limits?: ShellExecutionLimits;
+}
+export interface ExecOptions {
+    by?: string;
+    env?: Record<string, string>;
+    stdin?: string;
+    foreground?: boolean;
+    signal?: AbortSignal;
+    remote?: string;
+    limits?: ShellExecutionLimits;
+}
+export interface RuntimeComputerFace {
+    fs: KFileSystem;
+    shell: RuntimeShellFace;
+    env: RuntimeEnvFace;
+    exec(command: string | ExecInput, options?: ExecOptions): Promise<Record<string, unknown>>;
+}
+export interface RuntimeRemoteFace {
+    name: string;
+    exec(command: string | ExecInput, options?: ExecOptions): Promise<Record<string, unknown>>;
+}
+export interface RuntimeContext {
+    kind?: string;
+    name?: string;
+    input?: Record<string, unknown>;
+    args: Record<string, unknown>;
+    computer: RuntimeComputerFace;
+    agent: AgentSession;
+    exec(command: string | ExecInput, options?: ExecOptions): Promise<Record<string, unknown>>;
+    remote(name: string): RuntimeRemoteFace;
+    model(alias?: string): {
+        generate(req?: {
+            input?: string;
+            text?: string;
+            prompt?: string;
+        }): Promise<ModelResult>;
+        ask(input: string): Promise<ModelResult>;
+    };
+    stdout(text: string): {
+        type: 'stdout';
+        text: string;
+        code?: number;
+    };
+    stderr(text: string, code?: number): {
+        type: 'stderr';
+        text: string;
+        code: number;
+    };
+    result(output: {
+        stdout?: string;
+        stderr?: string;
+        code?: number;
+    }): {
+        stdout: string;
+        stderr: string;
+        code: number;
+    };
+    json(value: unknown): {
+        type: 'json';
+        value: unknown;
+    };
+    secret(name: string): string;
+    emit(name: string, data?: unknown, options?: {
+        level?: string;
+    }): Promise<EventEnvelope>;
+}
+export interface RuntimeCommand {
+    name?: string;
+    kind?: 'module' | 'shell' | 'markdown';
+    path?: string;
+    scope?: 'system' | 'agent';
+    agent?: string;
+    script?: string;
+    prompt?: string;
+    help?: string;
+    model?: string;
+    command?: string;
+    remote?: string;
+    limits?: ShellExecutionLimits;
+    argv?: string[] | ((input: Record<string, unknown>) => string[]);
+    handler?: (ctx: RuntimeContext, input?: Record<string, unknown>) => Promise<unknown> | unknown;
+    [key: string]: unknown;
+}
+export interface RuntimeHook {
+    event?: string;
+    kind: 'module' | 'shell' | 'markdown';
+    path?: string;
+    scope?: 'system' | 'agent';
+    agent?: string;
+    script?: string;
+    prompt?: string;
+    handler?: (ctx: HookContext<unknown>) => Promise<HookDecision | void> | HookDecision | void;
+    [key: string]: unknown;
+}
+export interface RuntimeCron {
+    name: string;
+    kind: 'module' | 'shell' | 'markdown';
+    path?: string;
+    scope?: 'system' | 'agent';
+    agent?: string;
+    user?: string;
+    script?: string;
+    prompt?: string;
+    when?: string;
+    schedule?: string;
+    handler?: (ctx: RuntimeContext, input?: Record<string, unknown>) => Promise<unknown> | unknown;
+    [key: string]: unknown;
+}
+export interface ContentBlock {
+    type: string;
+    text?: string;
+    path?: string;
+    ref?: string;
+    id?: string;
+    name?: string;
+    input?: unknown;
+    toolUseId?: string;
+    ok?: boolean;
+    status?: string;
+    [key: string]: unknown;
+}
+export interface KMessage {
+    id?: string;
+    seq?: number;
+    at?: string;
+    role: string;
+    content: ContentBlock[];
+    by?: string;
+    inputId?: string;
+    turnId?: string;
+    provider?: Record<string, unknown>;
+}
+export interface ModelRequest {
+    turnId?: string;
+    inputId?: string;
+    model?: string;
+    messages: KMessage[];
+    mode?: string;
+}
+export interface ModelUsage {
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+    audioInputTokens?: number;
+    audioOutputTokens?: number;
+    cachedInputTokens?: number;
+    [key: string]: unknown;
+}
+export type ModelFinishReason = 'stop' | 'length' | 'tool_use' | 'content_filter' | 'interrupted' | 'unknown';
+export interface ModelResult {
+    text: string;
+    message?: KMessage;
+    finishReason?: ModelFinishReason;
+    usage?: ModelUsage;
+    provider?: {
+        name?: string;
+        model?: string;
+        requestId?: string;
+        cacheRef?: string;
+        raw?: unknown;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+export type ModelEvent = {
+    type: 'content';
+    content: ContentBlock;
+    text?: string;
+    [key: string]: unknown;
+} | {
+    type: 'message';
+    message: KMessage;
+    usage?: ModelUsage;
+    finishReason?: ModelFinishReason;
+    provider?: ModelResult['provider'];
+    [key: string]: unknown;
+} | {
+    type: 'tool';
+    tool: string;
+    input?: unknown;
+    toolUseId?: string;
+    [key: string]: unknown;
+} | {
+    type: 'provider';
+    event: unknown;
+    [key: string]: unknown;
+} | {
+    type: 'error';
+    error: unknown;
+    [key: string]: unknown;
+};
+export interface LiveModelSession {
+    send(event: ContentBlock | ModelEvent): Promise<void>;
+    events(options?: {
+        signal?: AbortSignal;
+    }): AsyncIterable<ModelEvent>;
+    close(): Promise<void>;
+}
+export interface KModel {
+    id: string;
+    kind: 'llm';
+    capabilities?: Record<string, unknown>;
+    complete(req: ModelRequest): Promise<ModelResult>;
+    stream?(req: ModelRequest): AsyncIterable<ModelEvent>;
+    live?(req: ModelRequest): Promise<LiveModelSession>;
+}
+export interface ModelSet {
+    get(alias?: string): KModel;
+    aliases(): string[];
+}
+export interface TraceRecord {
+    traceSeq: number;
+    at: string;
+    type: string;
+    [key: string]: unknown;
+}
+export interface SessionRecord {
+    schema?: string;
+    id?: string;
+    agent?: string;
+    home?: string;
+    cwd?: string;
+    env?: Record<string, string>;
+    shell?: {
+        options?: {
+            errexit?: boolean;
+            nounset?: boolean;
+            pipefail?: boolean;
+        };
+        functions?: Record<string, string>;
+    };
+    mode?: ModeName;
+    scope?: AccessScope;
+    model?: string;
+    system?: string;
+    lastExitCode?: number;
+    createdAt?: string;
+    updatedAt?: string;
+    status?: string;
+    lastTraceSeq?: number;
+    worker?: {
+        owner: string;
+        token: string;
+        expiresAt: string;
+    };
+    [key: string]: unknown;
+}
+export interface EventEnvelope {
+    cursor: number;
+    at: string;
+    sessionId?: string;
+    agent?: string;
+    messageId?: string;
+    turnId?: string;
+    opId?: string;
+    parentOpId?: string;
+    approvalId?: string;
+    receiptId?: string;
+    event: RuntimeEvent;
+}
+export type MessageEventStatus = 'appended' | 'seen' | 'rejected';
+export type TurnEventStatus = 'queued' | 'running' | 'waiting_approval' | 'completed' | 'blocked' | 'failed' | 'cancelled';
+export type ContentEventKind = 'text' | 'reasoning' | 'image' | 'audio' | 'video' | 'data';
+export type ContentVisibility = 'public' | 'summary';
+export type ToolEventStatus = 'requested' | 'waiting_approval' | 'running' | 'completed' | 'failed' | 'denied' | 'sealed';
+export type ProcessEventStatus = 'started' | 'output' | 'completed' | 'failed' | 'cancelled' | 'uncertain' | 'sealed';
+export type ApprovalEventStatus = 'requested' | 'resolved' | 'cancelled' | 'expired';
+export type SignalLevel = 'info' | 'warn' | 'error';
+export type RuntimeEvent = {
+    type: 'message';
+    status: MessageEventStatus;
+    messageId: string;
+    role?: string;
+    by?: string;
+    reason?: string;
+    content?: ContentBlock[];
+    [key: string]: unknown;
+} | {
+    type: 'turn';
+    status: TurnEventStatus;
+    turnId: string;
+    messageId?: string;
+    reason?: string;
+    text?: string;
+    provider?: Record<string, unknown>;
+    [key: string]: unknown;
+} | {
+    type: 'content';
+    kind: ContentEventKind;
+    text?: string;
+    ref?: string;
+    path?: string;
+    visibility?: ContentVisibility;
+    content?: ContentBlock;
+    turnId?: string;
+    messageId?: string;
+    [key: string]: unknown;
+} | {
+    type: 'tool';
+    status: ToolEventStatus;
+    tool: string;
+    opId?: string;
+    input?: unknown;
+    result?: unknown;
+    reason?: string;
+    turnId?: string;
+    messageId?: string;
+    [key: string]: unknown;
+} | {
+    type: 'process';
+    status: ProcessEventStatus;
+    opId?: string;
+    command?: string;
+    argv?: string[];
+    script?: string;
+    kind?: string;
+    stream?: 'stdout' | 'stderr' | 'terminal';
+    text?: string;
+    code?: number;
+    signal?: string;
+    remote?: string;
+    receiptId?: string;
+    [key: string]: unknown;
+} | {
+    type: 'approval';
+    status: ApprovalEventStatus;
+    approvalId: string;
+    hook?: string;
+    message?: string;
+    risk?: 'low' | 'medium' | 'high';
+    decision?: 'approved' | 'rejected';
+    current?: unknown;
+    approval?: unknown;
+    [key: string]: unknown;
+} | {
+    type: 'signal';
+    name: string;
+    level?: SignalLevel;
+    data?: unknown;
+    [key: string]: unknown;
+};
+export interface HookContext<T> {
+    type: string;
+    agent: AgentSession;
+    ctx: RuntimeContext;
+    current: T;
+    data: T;
+    update(patch: Partial<T>): HookDecision;
+    reject(reason: string): HookDecision;
+    ask(request: ApprovalRequest): HookDecision;
+    emit: RuntimeContext['emit'];
+    decision?: HookDecision;
+}
+export interface ApprovalRequest {
+    message: string;
+    risk?: 'low' | 'medium' | 'high';
+    [key: string]: unknown;
+}
+export type HookDecision = {
+    type: 'pass';
+} | {
+    type: 'update';
+    patch: Record<string, unknown>;
+} | {
+    type: 'reject';
+    reason: string;
+} | {
+    type: 'ask';
+    request: ApprovalRequest;
+};

package/dist/types.js

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

package/dist/types.js.map

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

package/dist/utils.d.ts

@@ -0,0 +1,5 @@
+export declare function now(): string;
+export declare function id(prefix: string): string;
+export declare function sha256(value: string | Uint8Array): string;
+export declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;
+export declare function normalizeBy(by?: string): string;

package/dist/utils.js

@@ -0,0 +1,117 @@
+export function now() {
+    return new Date().toISOString();
+}
+export function id(prefix) {
+    const crypto = globalThis.crypto;
+    const uuid = crypto?.randomUUID?.() ?? randomId();
+    return `${prefix}_${uuid.replaceAll('-', '')}`;
+}
+export function sha256(value) {
+    const bytes = value instanceof Uint8Array ? value : new TextEncoder().encode(String(value));
+    const hash = sha256Bytes(bytes);
+    return hash.map((byte) => byte.toString(16).padStart(2, '0')).join('');
+}
+export function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        const abortSignal = signal;
+        if (abortSignal?.aborted) {
+            reject(abortSignal.reason ?? new Error('aborted'));
+            return;
+        }
+        const cleanup = () => abortSignal?.removeEventListener('abort', abort);
+        const timer = setTimeout(() => {
+            cleanup();
+            resolve();
+        }, ms);
+        const abort = () => {
+            clearTimeout(timer);
+            cleanup();
+            reject(abortSignal?.reason ?? new Error('aborted'));
+        };
+        abortSignal?.addEventListener('abort', abort, { once: true });
+    });
+}
+export function normalizeBy(by) {
+    return by || 'program:unknown';
+}
+function randomId() {
+    const bytes = new Uint8Array(16);
+    if (globalThis.crypto?.getRandomValues) {
+        globalThis.crypto.getRandomValues(bytes);
+    }
+    else {
+        for (let index = 0; index < bytes.length; index += 1)
+            bytes[index] = Math.floor(Math.random() * 256);
+    }
+    return [...bytes].map((byte) => byte.toString(16).padStart(2, '0')).join('');
+}
+function sha256Bytes(message) {
+    const k = [
+        0x428a2f98, 0x71374491, 0xb5c0fbcf, 0xe9b5dba5, 0x3956c25b, 0x59f111f1, 0x923f82a4, 0xab1c5ed5,
+        0xd807aa98, 0x12835b01, 0x243185be, 0x550c7dc3, 0x72be5d74, 0x80deb1fe, 0x9bdc06a7, 0xc19bf174,
+        0xe49b69c1, 0xefbe4786, 0x0fc19dc6, 0x240ca1cc, 0x2de92c6f, 0x4a7484aa, 0x5cb0a9dc, 0x76f988da,
+        0x983e5152, 0xa831c66d, 0xb00327c8, 0xbf597fc7, 0xc6e00bf3, 0xd5a79147, 0x06ca6351, 0x14292967,
+        0x27b70a85, 0x2e1b2138, 0x4d2c6dfc, 0x53380d13, 0x650a7354, 0x766a0abb, 0x81c2c92e, 0x92722c85,
+        0xa2bfe8a1, 0xa81a664b, 0xc24b8b70, 0xc76c51a3, 0xd192e819, 0xd6990624, 0xf40e3585, 0x106aa070,
+        0x19a4c116, 0x1e376c08, 0x2748774c, 0x34b0bcb5, 0x391c0cb3, 0x4ed8aa4a, 0x5b9cca4f, 0x682e6ff3,
+        0x748f82ee, 0x78a5636f, 0x84c87814, 0x8cc70208, 0x90befffa, 0xa4506ceb, 0xbef9a3f7, 0xc67178f2,
+    ];
+    const h = [
+        0x6a09e667, 0xbb67ae85, 0x3c6ef372, 0xa54ff53a,
+        0x510e527f, 0x9b05688c, 0x1f83d9ab, 0x5be0cd19,
+    ];
+    const bitLength = message.length * 8;
+    const withOne = message.length + 1;
+    const zeroPadding = (64 - ((withOne + 8) % 64)) % 64;
+    const padded = new Uint8Array(withOne + zeroPadding + 8);
+    padded.set(message);
+    padded[message.length] = 0x80;
+    const view = new DataView(padded.buffer);
+    view.setUint32(padded.length - 8, Math.floor(bitLength / 0x100000000));
+    view.setUint32(padded.length - 4, bitLength >>> 0);
+    const w = new Uint32Array(64);
+    for (let offset = 0; offset < padded.length; offset += 64) {
+        for (let index = 0; index < 16; index += 1)
+            w[index] = view.getUint32(offset + index * 4);
+        for (let index = 16; index < 64; index += 1) {
+            const s0 = rotr(w[index - 15], 7) ^ rotr(w[index - 15], 18) ^ (w[index - 15] >>> 3);
+            const s1 = rotr(w[index - 2], 17) ^ rotr(w[index - 2], 19) ^ (w[index - 2] >>> 10);
+            w[index] = (w[index - 16] + s0 + w[index - 7] + s1) >>> 0;
+        }
+        let [a, b, c, d, e, f, g, hh] = h;
+        for (let index = 0; index < 64; index += 1) {
+            const s1 = rotr(e, 6) ^ rotr(e, 11) ^ rotr(e, 25);
+            const ch = (e & f) ^ (~e & g);
+            const temp1 = (hh + s1 + ch + k[index] + w[index]) >>> 0;
+            const s0 = rotr(a, 2) ^ rotr(a, 13) ^ rotr(a, 22);
+            const maj = (a & b) ^ (a & c) ^ (b & c);
+            const temp2 = (s0 + maj) >>> 0;
+            hh = g;
+            g = f;
+            f = e;
+            e = (d + temp1) >>> 0;
+            d = c;
+            c = b;
+            b = a;
+            a = (temp1 + temp2) >>> 0;
+        }
+        h[0] = (h[0] + a) >>> 0;
+        h[1] = (h[1] + b) >>> 0;
+        h[2] = (h[2] + c) >>> 0;
+        h[3] = (h[3] + d) >>> 0;
+        h[4] = (h[4] + e) >>> 0;
+        h[5] = (h[5] + f) >>> 0;
+        h[6] = (h[6] + g) >>> 0;
+        h[7] = (h[7] + hh) >>> 0;
+    }
+    return h.flatMap((word) => [
+        (word >>> 24) & 0xff,
+        (word >>> 16) & 0xff,
+        (word >>> 8) & 0xff,
+        word & 0xff,
+    ]);
+}
+function rotr(value, bits) {
+    return (value >>> bits) | (value << (32 - bits));
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/dist/vbash.d.ts

@@ -0,0 +1,40 @@
+export interface ConcreteCommand {
+    cmd: string;
+    args: string[];
+    words: string[];
+    wordTokens: ShellWordToken[];
+    script: string;
+}
+export interface ShellCommandSegment extends ConcreteCommand {
+    separator: 'start' | ';' | '&&' | '||' | '|';
+    background: boolean;
+}
+export interface ShellWordPart {
+    text: string;
+    quote?: '"' | "'";
+}
+export interface ShellWordToken {
+    text: string;
+    parts: ShellWordPart[];
+    quoted: boolean;
+    globbable: boolean;
+}
+export declare function parseConcreteCommands(script: string): ConcreteCommand[];
+export declare function parseShellCommandSegments(script: string): ShellCommandSegment[];
+export declare function splitShellCommands(script: string): string[];
+export declare function isSimpleShellCommand(script: string): boolean;
+export declare function stripShellCommandSubstitutions(script: string): string;
+export declare function isGovernableShellScript(script: string): boolean;
+export declare function parseShellWords(script: string): string[];
+export declare function parseShellTokens(script: string): ShellWordToken[];
+export interface RemotePathRewriteResult {
+    script: string;
+    unresolved: string[];
+    resolved: RemotePathResolution[];
+}
+export interface RemotePathResolution {
+    kPath: string;
+    realPath: string;
+    mode?: 'ro' | 'rw';
+}
+export declare function rewriteKPathsForRemote(script: string, resolveRealPath: (path: string) => string | RemotePathResolution | undefined, home?: string): RemotePathRewriteResult;