@kruntime/komputer 0.1.0

package/dist/shell/builtins/run.js

@@ -0,0 +1,29 @@
+import { filesystemBuiltins } from "./commands/filesystem.js";
+import { networkBuiltins } from "./commands/network.js";
+import { processBuiltins } from "./commands/process.js";
+import { systemBuiltins } from "./commands/system.js";
+import { textBuiltins } from "./commands/text.js";
+import { registerBuiltinHelp } from "./catalog.js";
+import { normalizeBuiltinEntry, normalizeBuiltinOutput } from "./runtime.js";
+export { builtinErrorText } from "./runtime.js";
+export { builtinHelp, builtinHelpEntries } from "./catalog.js";
+const BUILTIN_ENTRIES = {
+    ...filesystemBuiltins,
+    ...textBuiltins,
+    ...systemBuiltins,
+    ...processBuiltins,
+    ...networkBuiltins,
+};
+const BUILTIN_SPECS = Object.fromEntries(Object.entries(BUILTIN_ENTRIES).map(([name, entry]) => [name, normalizeBuiltinEntry(entry)]));
+for (const [name, spec] of Object.entries(BUILTIN_SPECS))
+    registerBuiltinHelp(name, spec.help);
+export async function runBuiltin(ctx, cmd, args, stdin = '', signal) {
+    const spec = BUILTIN_SPECS[cmd];
+    if (spec) {
+        if (args.length === 1 && args[0] === '--help' && spec.help)
+            return { stdout: `${spec.help}\n`, stderr: '', code: 0 };
+        return normalizeBuiltinOutput(await spec.handler(ctx, args, stdin, signal));
+    }
+    throw new Error(`unknown K builtin: ${cmd}`);
+}
+//# sourceMappingURL=run.js.map

package/dist/shell/builtins/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../../../../packages/komputer/src/shell/builtins/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAA;AAG5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAE9D,MAAM,eAAe,GAAiC;IACpD,GAAG,kBAAkB;IACrB,GAAG,YAAY;IACf,GAAG,cAAc;IACjB,GAAG,eAAe;IAClB,GAAG,eAAe;CACnB,CAAA;AAED,MAAM,aAAa,GAAgC,MAAM,CAAC,WAAW,CACnE,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC,CAC7F,CAAA;AAED,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC;IAAE,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;AAE9F,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAmB,EAAE,GAAW,EAAE,IAAc,EAAE,KAAK,GAAG,EAAE,EAAE,MAAoB;IACjH,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,CAAA;IAC/B,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAA;QACpH,OAAO,sBAAsB,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAA;IAC7E,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,sBAAsB,GAAG,EAAE,CAAC,CAAA;AAC9C,CAAC"}

package/dist/shell/builtins/runtime.d.ts

@@ -0,0 +1,83 @@
+import type { KFileSystem } from '../../vfs.js';
+import type { RuntimeCommand, NetworkResponse } from '../../types.js';
+import type { VJobRecord, VProcessRecord } from '../../vprocess.js';
+import type { ShellOptions } from '../runtime.js';
+export interface BuiltinRuntime {
+    cwd: string;
+    home: string;
+    agentName: string;
+    sessionId: string;
+    fs: KFileSystem;
+    commands: Map<string, RuntimeCommand>;
+    functions: Set<string>;
+    shellPath(path: string): string;
+    cd(path: string): Promise<void>;
+    sleep(ms: number, signal?: AbortSignal): Promise<void>;
+    jobs(): Promise<VJobRecord[]>;
+    processes(): Promise<VProcessRecord[]>;
+    kill(target: string, signal?: string): Promise<VProcessRecord[]>;
+    wait(target: string): Promise<{
+        status: string;
+        vpid?: string;
+        jobId?: string;
+        receiptId?: string;
+        recovered?: boolean;
+        code?: number;
+    }>;
+    foreground(target: string): Promise<{
+        status: string;
+        vpid?: string;
+        jobId?: string;
+        receiptId?: string;
+        recovered?: boolean;
+        code?: number;
+        stdout?: string;
+        stderr?: string;
+    }>;
+    background(target: string): Promise<VProcessRecord>;
+    env(): Record<string, string>;
+    setEnv(name: string, value: string): Promise<void>;
+    unsetEnv(name: string): Promise<void>;
+    shellOptions(): ShellOptions;
+    setShellOptions(patch: Partial<ShellOptions>): Promise<void>;
+    fetchNetwork(url: string, init?: {
+        method?: string;
+        headers?: Record<string, string>;
+        body?: string;
+    }): Promise<NetworkResponse>;
+    exec(script: string, options?: {
+        env?: Record<string, string>;
+        replaceEnv?: boolean;
+        signal?: AbortSignal;
+    }): Promise<Record<string, unknown>>;
+    source(script: string, options?: {
+        env?: Record<string, string>;
+        signal?: AbortSignal;
+    }): Promise<Record<string, unknown>>;
+    trace(type: string, data: Record<string, unknown>): Promise<void>;
+}
+export interface BuiltinResult {
+    stdout?: string;
+    stderr?: string;
+    code?: number;
+}
+export interface NormalizedBuiltinResult {
+    stdout: string;
+    stderr: string;
+    code: number;
+}
+export type BuiltinOutput = string | BuiltinResult;
+export type BuiltinHandler = (ctx: BuiltinRuntime, args: string[], stdin: string, signal?: AbortSignal) => Promise<BuiltinOutput> | BuiltinOutput;
+export interface BuiltinSpec {
+    handler: BuiltinHandler;
+    help: string;
+}
+export type BuiltinEntry = BuiltinHandler | BuiltinSpec;
+export declare function builtinSpec(handler: BuiltinHandler, help: string): BuiltinSpec;
+export declare function normalizeBuiltinEntry(entry: BuiltinEntry): BuiltinSpec;
+export declare function normalizeBuiltinOutput(output: BuiltinOutput): NormalizedBuiltinResult;
+export declare function readBuiltinInput(ctx: BuiltinRuntime, paths: string[], stdin?: string): Promise<string>;
+export declare function quoteEnvValue(value: string): string;
+export declare function quoteShellWord(value: string): string;
+export declare function unsupportedOption(command: string, option: string): Error;
+export declare function builtinErrorText(cmd: string, error: unknown): string;

package/dist/shell/builtins/runtime.js

@@ -0,0 +1,46 @@
+export function builtinSpec(handler, help) {
+    return { handler, help: help.trim() };
+}
+export function normalizeBuiltinEntry(entry) {
+    return typeof entry === 'function' ? { handler: entry, help: '' } : entry;
+}
+export function normalizeBuiltinOutput(output) {
+    if (typeof output === 'string')
+        return { stdout: output, stderr: '', code: 0 };
+    return {
+        stdout: output.stdout || '',
+        stderr: output.stderr || '',
+        code: output.code ?? 0,
+    };
+}
+export async function readBuiltinInput(ctx, paths, stdin = '') {
+    if (!paths.length)
+        return stdin;
+    const chunks = [];
+    for (const path of paths)
+        chunks.push(path === '-' ? stdin : await ctx.fs.readText(ctx.shellPath(path)));
+    return chunks.join('');
+}
+export function quoteEnvValue(value) {
+    if (/^[A-Za-z0-9_./:@%+=,-]*$/.test(value))
+        return value;
+    return `'${value.replaceAll("'", "'\\''")}'`;
+}
+export function quoteShellWord(value) {
+    if (/^[A-Za-z0-9_./:@%+=,-]+$/.test(value))
+        return value;
+    return `'${value.replaceAll("'", "'\\''")}'`;
+}
+export function unsupportedOption(command, option) {
+    return new Error(`${command}: unsupported option: ${option}`);
+}
+export function builtinErrorText(cmd, error) {
+    if (cmd === 'false' || cmd === 'test' || cmd === '[' || cmd === '[[')
+        return '';
+    if (cmd === 'grep' && error instanceof Error && error.message === 'grep:no-match')
+        return '';
+    if (cmd === 'command' && error instanceof Error && error.message === 'command:not-found')
+        return '';
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=runtime.js.map

package/dist/shell/builtins/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../../../../packages/komputer/src/shell/builtins/runtime.ts"],"names":[],"mappings":"AAuDA,MAAM,UAAU,WAAW,CAAC,OAAuB,EAAE,IAAY;IAC/D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAA;AACvC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAmB;IACvD,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAA;AAC3E,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAqB;IAC1D,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAA;IAC9E,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;QAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;QAC3B,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC;KACvB,CAAA;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAmB,EAAE,KAAe,EAAE,KAAK,GAAG,EAAE;IACrF,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,KAAK,CAAA;IAC/B,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACxG,OAAO,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AACxB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,IAAI,0BAA0B,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IACxD,OAAO,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAA;AAC9C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,IAAI,0BAA0B,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IACxD,OAAO,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAA;AAC9C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,MAAc;IAC/D,OAAO,IAAI,KAAK,CAAC,GAAG,OAAO,yBAAyB,MAAM,EAAE,CAAC,CAAA;AAC/D,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,KAAc;IAC1D,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,EAAE,CAAA;IAC/E,IAAI,GAAG,KAAK,MAAM,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,eAAe;QAAE,OAAO,EAAE,CAAA;IAC5F,IAAI,GAAG,KAAK,SAAS,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,mBAAmB;QAAE,OAAO,EAAE,CAAA;IACnG,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAC/D,CAAC"}

package/dist/shell/builtins/text.d.ts

@@ -0,0 +1,90 @@
+export interface GrepArgs {
+    patterns: string[];
+    paths: string[];
+    fixedStrings: boolean;
+    ignoreCase: boolean;
+    invert: boolean;
+    lineNumber: boolean;
+    recursive: boolean;
+    count: boolean;
+    filesWithMatches: boolean;
+    quiet: boolean;
+    onlyMatching: boolean;
+    noFilename: boolean;
+    withFilename: boolean;
+    maxCount?: number;
+    beforeContext: number;
+    afterContext: number;
+    includes: string[];
+    excludes: string[];
+    excludeDirs: string[];
+}
+export interface WcArgs {
+    fields: WcField[];
+    paths: string[];
+}
+export type WcField = 'lines' | 'words' | 'bytes';
+export interface HeadTailArgs {
+    count: number;
+    unit: 'lines' | 'bytes';
+    fromLine?: number;
+    fromByte?: number;
+    paths: string[];
+}
+export interface CutArgs {
+    mode: 'fields' | 'chars';
+    delimiter: string;
+    fields: NumberSelection[];
+    chars: NumberSelection[];
+    paths: string[];
+}
+export interface NumberSelection {
+    start: number;
+    end?: number;
+}
+export interface SedArgs {
+    expression: string;
+    paths: string[];
+    quiet: boolean;
+    inPlace: boolean;
+    backupSuffix?: string;
+}
+export interface UniqArgs {
+    count: boolean;
+    repeatedOnly: boolean;
+    uniqueOnly: boolean;
+    ignoreCase: boolean;
+    paths: string[];
+}
+export interface AwkArgs {
+    program: string;
+    fieldSeparator?: string;
+    paths: string[];
+}
+export declare function formatPrintf(args: string[]): string;
+export declare function parseGrepArgs(args: string[]): GrepArgs;
+export declare function makeTextMatcher(patterns: string[], options: {
+    fixedStrings: boolean;
+    ignoreCase: boolean;
+}): (line: string) => boolean;
+export declare function extractTextMatches(patterns: string[], line: string, options: {
+    fixedStrings: boolean;
+    ignoreCase: boolean;
+}): string[];
+export declare function parseWcArgs(args: string[]): WcArgs;
+export declare function parseHeadTailArgs(args: string[], fallback: number, command?: string): HeadTailArgs;
+export declare function parseCutArgs(args: string[]): CutArgs;
+export declare function parseUniqArgs(args: string[]): UniqArgs;
+export declare function parseSedArgs(args: string[]): SedArgs;
+export declare function parseAwkArgs(args: string[]): AwkArgs;
+export declare function applyUniq(input: string, options: UniqArgs): string;
+export declare function applySed(input: string, expression: string, options?: {
+    quiet?: boolean;
+}): string;
+export declare function applyAwk(input: string, program: string, options?: {
+    fieldSeparator?: string;
+}): string;
+export declare function translateText(input: string, args: string[]): string;
+export declare function takeLines(input: string, count: number, side: 'head' | 'tail', fromLine?: number): string;
+export declare function takeBytes(input: string, count: number, side: 'head' | 'tail', fromByte?: number): string;
+export declare function splitLines(input: string): string[];