@leaflow/sdk 0.0.0-dev.451.gfd4baf5 → 0.0.0-dev.455.ge99314c

package/dist/proto/leaflow/fleet/command/v1/command_pb.d.ts

@@ -0,0 +1,158 @@
+import type { GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
+import type { Duration } from "@bufbuild/protobuf/wkt";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file leaflow/fleet/command/v1/command.proto.
+ */
+export declare const file_leaflow_fleet_command_v1_command: GenFile;
+/**
+ * The request of RunCommand.
+ *
+ * @generated from message leaflow.fleet.command.v1.RunCommandRequest
+ */
+export type RunCommandRequest = Message<"leaflow.fleet.command.v1.RunCommandRequest"> & {
+    /**
+     * The platform user who asked for the command.
+     *
+     * @generated from field: string user_id = 1;
+     */
+    userId: string;
+    /**
+     * The user's directory account (leaflow.fleet.directory.v1 Account), whose
+     * user_id is the one above.
+     *
+     * @generated from field: string username = 2;
+     */
+    username: string;
+    /**
+     * The command line for the account's login shell (`shell -c command`).
+     *
+     * @generated from field: string command = 3;
+     */
+    command: string;
+    /**
+     * Kills the command, and every process it started, when it has not ended
+     * this long after it started: the shell still runs or its output is still
+     * open. 1 to 300 seconds; unset: 60 seconds. As with ssh, a command ends
+     * without waiting for what it left running in the background with its
+     * output elsewhere (`nohup daemon >log 2>&1 &`), and that keeps running.
+     *
+     * @generated from field: google.protobuf.Duration timeout = 4;
+     */
+    timeout?: Duration | undefined;
+};
+/**
+ * Describes the message leaflow.fleet.command.v1.RunCommandRequest.
+ * Use `create(RunCommandRequestSchema)` to create a new message.
+ */
+export declare const RunCommandRequestSchema: GenMessage<RunCommandRequest>;
+/**
+ * The response of RunCommand.
+ *
+ * @generated from message leaflow.fleet.command.v1.RunCommandResponse
+ */
+export type RunCommandResponse = Message<"leaflow.fleet.command.v1.RunCommandResponse"> & {
+    /**
+     * How the command ended.
+     *
+     * @generated from oneof leaflow.fleet.command.v1.RunCommandResponse.termination
+     */
+    termination: {
+        /**
+         * It exited with this status (wait(2) WEXITSTATUS), 0 being success.
+         * Any other value is the command's own verdict.
+         *
+         * @generated from field: int32 exit_status = 1;
+         */
+        value: number;
+        case: "exitStatus";
+    } | {
+        /**
+         * A signal ended it (wait(2) WTERMSIG), such as 9 when the timeout
+         * killed it.
+         *
+         * @generated from field: int32 signal = 2;
+         */
+        value: number;
+        case: "signal";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+    /**
+     * The timeout ended it.
+     *
+     * @generated from field: bool timed_out = 3;
+     */
+    timedOut: boolean;
+    /**
+     * What it wrote to standard output, at most 1 MiB; the rest is discarded.
+     *
+     * @generated from field: bytes stdout = 4;
+     */
+    stdout: Uint8Array;
+    /**
+     * stdout is cut short.
+     *
+     * @generated from field: bool stdout_truncated = 5;
+     */
+    stdoutTruncated: boolean;
+    /**
+     * What it wrote to standard error, at most 1 MiB; the rest is discarded.
+     *
+     * @generated from field: bytes stderr = 6;
+     */
+    stderr: Uint8Array;
+    /**
+     * stderr is cut short.
+     *
+     * @generated from field: bool stderr_truncated = 7;
+     */
+    stderrTruncated: boolean;
+};
+/**
+ * Describes the message leaflow.fleet.command.v1.RunCommandResponse.
+ * Use `create(RunCommandResponseSchema)` to create a new message.
+ */
+export declare const RunCommandResponseSchema: GenMessage<RunCommandResponse>;
+/**
+ * Runs commands. Served by the daemon; the service calls it.
+ *
+ * @generated from service leaflow.fleet.command.v1.CommandService
+ */
+export declare const CommandService: GenService<{
+    /**
+     * Runs one command and returns once it exited or was killed, with what it
+     * wrote. A command that fails is still a successful call: its exit status
+     * is its result.
+     *
+     * Fails with:
+     *   - INVALID_ARGUMENT and reason INVALID_REQUEST for an empty command,
+     *     one longer than 65536 bytes or one containing a NUL byte, or a
+     *     timeout outside 1 to 300 seconds;
+     *   - NOT_FOUND and reason USER_NOT_FOUND for an account the machine's
+     *     copy of the directory does not hold for user_id;
+     *   - PERMISSION_DENIED and reason USER_NOT_ALLOWED for an account that
+     *     may not log in to the machine or one the machine does not serve (a
+     *     conflict);
+     *   - PERMISSION_DENIED and reason ACCOUNT_EXPIRED when PAM reports the
+     *     account expired (PAM_ACCT_EXPIRED);
+     *   - PERMISSION_DENIED and reason PAM_PERMISSION_DENIED when PAM refuses
+     *     the account or the session (PAM_PERM_DENIED), with metadata
+     *     "pamMessage", the text PAM gave;
+     *   - INTERNAL and reason COMMAND_START_FAILED when the shell could not
+     *     start; nothing ran;
+     *   - INTERNAL and reason COMMAND_LOST when the Agent lost the command
+     *     while it ran: it may have run in part, and what it wrote is gone.
+     * Calling again runs the command again: a caller that lost the result,
+     * such as with CONNECTION_LOST, does not know whether it ran. A call
+     * without a timeout may run the command's timeout and 10 seconds more.
+     *
+     * @generated from rpc leaflow.fleet.command.v1.CommandService.RunCommand
+     */
+    runCommand: {
+        methodKind: "unary";
+        input: typeof RunCommandRequestSchema;
+        output: typeof RunCommandResponseSchema;
+    };
+}>;

package/dist/proto/leaflow/fleet/command/v1/command_pb.js

@@ -0,0 +1,25 @@
+// @generated by protoc-gen-es v2.16.0 with parameter "target=ts,import_extension=js"
+// @generated from file leaflow/fleet/command/v1/command.proto (package leaflow.fleet.command.v1, syntax proto3)
+/* eslint-disable */
+import { fileDesc, messageDesc, serviceDesc } from "@bufbuild/protobuf/codegenv2";
+import { file_google_protobuf_duration } from "@bufbuild/protobuf/wkt";
+/**
+ * Describes the file leaflow/fleet/command/v1/command.proto.
+ */
+export const file_leaflow_fleet_command_v1_command = /*@__PURE__*/ fileDesc("CiZsZWFmbG93L2ZsZWV0L2NvbW1hbmQvdjEvY29tbWFuZC5wcm90bxIYbGVhZmxvdy5mbGVldC5jb21tYW5kLnYxInMKEVJ1bkNvbW1hbmRSZXF1ZXN0Eg8KB3VzZXJfaWQYASABKAkSEAoIdXNlcm5hbWUYAiABKAkSDwoHY29tbWFuZBgDIAEoCRIqCgd0aW1lb3V0GAQgASgLMhkuZ29vZ2xlLnByb3RvYnVmLkR1cmF0aW9uIrMBChJSdW5Db21tYW5kUmVzcG9uc2USFQoLZXhpdF9zdGF0dXMYASABKAVIABIQCgZzaWduYWwYAiABKAVIABIRCgl0aW1lZF9vdXQYAyABKAgSDgoGc3Rkb3V0GAQgASgMEhgKEHN0ZG91dF90cnVuY2F0ZWQYBSABKAgSDgoGc3RkZXJyGAYgASgMEhgKEHN0ZGVycl90cnVuY2F0ZWQYByABKAhCDQoLdGVybWluYXRpb24yeQoOQ29tbWFuZFNlcnZpY2USZwoKUnVuQ29tbWFuZBIrLmxlYWZsb3cuZmxlZXQuY29tbWFuZC52MS5SdW5Db21tYW5kUmVxdWVzdBosLmxlYWZsb3cuZmxlZXQuY29tbWFuZC52MS5SdW5Db21tYW5kUmVzcG9uc2VCPlo8Z2l0aHViLmNvbS9sZWFmbG93YXBpcy9sZWFmbG93LWdvL2ZsZWV0L2NvbW1hbmQvdjE7Y29tbWFuZHYxYgZwcm90bzM", [file_google_protobuf_duration]);
+/**
+ * Describes the message leaflow.fleet.command.v1.RunCommandRequest.
+ * Use `create(RunCommandRequestSchema)` to create a new message.
+ */
+export const RunCommandRequestSchema = /*@__PURE__*/ messageDesc(file_leaflow_fleet_command_v1_command, 0);
+/**
+ * Describes the message leaflow.fleet.command.v1.RunCommandResponse.
+ * Use `create(RunCommandResponseSchema)` to create a new message.
+ */
+export const RunCommandResponseSchema = /*@__PURE__*/ messageDesc(file_leaflow_fleet_command_v1_command, 1);
+/**
+ * Runs commands. Served by the daemon; the service calls it.
+ *
+ * @generated from service leaflow.fleet.command.v1.CommandService
+ */
+export const CommandService = /*@__PURE__*/ serviceDesc(file_leaflow_fleet_command_v1_command, 0);