@struktoai/mirage-node 0.0.5 → 0.0.6

package/dist/commands/builtin/ssh/index.js

@@ -0,0 +1,20 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { makeGenericCommands } from '@struktoai/mirage-core/commands/builtin/generic_bind/index';
+import { ResourceName } from '@struktoai/mirage-core/types';
+import { SSH_IO } from "./io.js";
+export const SSH_COMMANDS = [
+    ...makeGenericCommands(ResourceName.SSH, SSH_IO),
+];
+//# sourceMappingURL=index.js.map

package/dist/commands/builtin/ssh/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/commands/builtin/ssh/index.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAEvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4DAA4D,CAAA;AAEhG,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAE3D,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAEhC,MAAM,CAAC,MAAM,YAAY,GAAiC;IACxD,GAAG,mBAAmB,CAAc,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC;CAC9D,CAAA"}

package/dist/commands/builtin/ssh/io.d.ts

@@ -0,0 +1,4 @@
+import { type CommandIO } from '@struktoai/mirage-core/commands/builtin/generic_bind/index';
+import type { SSHAccessor } from '../../../accessor/ssh.ts';
+export declare const SSH_IO: CommandIO<SSHAccessor>;
+//# sourceMappingURL=io.d.ts.map

package/dist/commands/builtin/ssh/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../../../src/commands/builtin/ssh/io.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,KAAK,SAAS,EAAW,MAAM,4DAA4D,CAAA;AACpG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAqB3D,eAAO,MAAM,MAAM,EAAE,SAAS,CAAC,WAAW,CAuBzC,CAAA"}

package/dist/commands/builtin/ssh/io.js

@@ -0,0 +1,58 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { rangeOf } from '@struktoai/mirage-core/commands/builtin/generic_bind/index';
+import { appendBytes as sshAppend } from "../../../core/ssh/append.js";
+import { SCOPE_ERROR } from "../../../core/ssh/constants.js";
+import { copy as sshCopy } from "../../../core/ssh/copy.js";
+import { create as sshCreate } from "../../../core/ssh/create.js";
+import { size as sshDu, entries as sshDuAll } from "../../../core/ssh/du/index.js";
+import { exists as sshExists } from "../../../core/ssh/exists.js";
+import { find as sshFind } from "../../../core/ssh/find.js";
+import { mkdir as sshMkdir } from "../../../core/ssh/mkdir.js";
+import { read as sshRead } from "../../../core/ssh/read.js";
+import { readdir as sshReaddir } from "../../../core/ssh/readdir.js";
+import { rename as sshRename } from "../../../core/ssh/rename.js";
+import { rmR as sshRmR } from "../../../core/ssh/rm.js";
+import { rmdir as sshRmdir } from "../../../core/ssh/rmdir.js";
+import { setAttrs as sshSetAttrs } from "../../../core/ssh/set_attrs.js";
+import { stat as sshStat } from "../../../core/ssh/stat.js";
+import { stream as sshStream } from "../../../core/ssh/stream.js";
+import { truncate as sshTruncate } from "../../../core/ssh/truncate.js";
+import { unlink as sshUnlink } from "../../../core/ssh/unlink.js";
+import { writeBytes as sshWrite } from "../../../core/ssh/write.js";
+export const SSH_IO = {
+    maxGlobMatches: SCOPE_ERROR,
+    readdir: sshReaddir,
+    readBytes: sshRead,
+    readRange: rangeOf(sshRead),
+    readStream: sshStream,
+    stat: sshStat,
+    isMounted: () => true,
+    local: false,
+    write: sshWrite,
+    exists: sshExists,
+    mkdir: (accessor, path, parents) => sshMkdir(accessor, path, parents === true),
+    unlink: sshUnlink,
+    rmdir: sshRmdir,
+    rmR: sshRmR,
+    rename: sshRename,
+    copy: sshCopy,
+    create: sshCreate,
+    truncate: sshTruncate,
+    append: sshAppend,
+    find: sshFind,
+    du: { size: sshDu, entries: sshDuAll },
+    setAttrs: sshSetAttrs,
+};
+//# sourceMappingURL=io.js.map

package/dist/commands/builtin/ssh/io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.js","sourceRoot":"","sources":["../../../../src/commands/builtin/ssh/io.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAEvE,OAAO,EAAkB,OAAO,EAAE,MAAM,4DAA4D,CAAA;AAEpG,OAAO,EAAE,WAAW,IAAI,SAAS,EAAE,MAAM,6BAA6B,CAAA;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAA;AAC5D,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAC3D,OAAO,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,EAAE,IAAI,IAAI,KAAK,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,+BAA+B,CAAA;AAClF,OAAO,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAC3D,OAAO,EAAE,KAAK,IAAI,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAC3D,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,8BAA8B,CAAA;AACpE,OAAO,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,EAAE,GAAG,IAAI,MAAM,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,EAAE,KAAK,IAAI,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,EAAE,QAAQ,IAAI,WAAW,EAAE,MAAM,gCAAgC,CAAA;AACxE,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAC3D,OAAO,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,EAAE,QAAQ,IAAI,WAAW,EAAE,MAAM,+BAA+B,CAAA;AACvE,OAAO,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,EAAE,UAAU,IAAI,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AAEnE,MAAM,CAAC,MAAM,MAAM,GAA2B;IAC5C,cAAc,EAAE,WAAW;IAC3B,OAAO,EAAE,UAAU;IACnB,SAAS,EAAE,OAAO;IAClB,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC;IAC3B,UAAU,EAAE,SAAS;IACrB,IAAI,EAAE,OAAO;IACb,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI;IACrB,KAAK,EAAE,KAAK;IACZ,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,SAAS;IACjB,KAAK,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC9E,MAAM,EAAE,SAAS;IACjB,KAAK,EAAE,QAAQ;IACf,GAAG,EAAE,MAAM;IACX,MAAM,EAAE,SAAS;IACjB,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,SAAS;IACjB,QAAQ,EAAE,WAAW;IACrB,MAAM,EAAE,SAAS;IACjB,IAAI,EAAE,OAAO;IACb,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE;IACtC,QAAQ,EAAE,WAAW;CACtB,CAAA"}

package/dist/commands/cli/builtin/hf/accessor.d.ts

@@ -0,0 +1,37 @@
+import type { CLIInvocation } from '@struktoai/mirage-core/commands/cli/types';
+import type { FlagView } from '@struktoai/mirage-core/commands/spec/index';
+import { IOResult } from '@struktoai/mirage-core/io/types';
+import type { ByteSource } from '@struktoai/mirage-core/io/types';
+import { HfHubAccessor } from '../../../../accessor/hf_hub.ts';
+/** The repo kind a line names, defaulting the way upstream does. */
+export declare function repoTypeOf(fl: FlagView): string;
+/**
+ * A Hub handle for the repository this line named.
+ *
+ * The CLI builds one per invocation rather than owning a second Hub client:
+ * an accessor is a value object here, holding the endpoint, the credential
+ * and which repository is being addressed, so `hf` gets the mount's tree walk
+ * and commit builder for free. It reaches no mount, which is what keeps this
+ * an account CLI.
+ */
+export declare function hubFor(inv: CLIInvocation, repoId: string, repoType: string, revision?: string): HfHubAccessor;
+/**
+ * Refuse a line that left a required operand empty.
+ *
+ * `Operand.required` is inert outside the clap dialect on purpose: only clap
+ * names the empty slots, and under every other style the refusal stays the
+ * leaf's own business, worded by the command (`executor/command/cli.ts`). hf is
+ * argparse, so each leaf that takes operands calls this, and it words the
+ * refusal the way argparse does rather than letting the line reach the Hub and
+ * come back as an authentication error.
+ */
+export declare function requireOperands(inv: CLIInvocation, names: readonly string[]): void;
+export declare function textOut(text: string, mutated?: boolean): [ByteSource, IOResult];
+/**
+ * Refuse a verb that cannot work anonymously, before it is tried.
+ *
+ * The Hub answers 401 "Invalid username or password." for an unauthenticated
+ * write, which reads as a wrong credential rather than as a missing one.
+ */
+export declare function requireToken(inv: CLIInvocation, what: string): void;
+//# sourceMappingURL=accessor.d.ts.map

package/dist/commands/cli/builtin/hf/accessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessor.d.ts","sourceRoot":"","sources":["../../../../../src/commands/cli/builtin/hf/accessor.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAA;AAE9E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4CAA4C,CAAA;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAE1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAM9D,oEAAoE;AACpE,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,CAI/C;AAED;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CACpB,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,GAChB,aAAa,CAWf;AAOD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAKlF;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAE/E;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAKnE"}

package/dist/commands/cli/builtin/hf/accessor.js

@@ -0,0 +1,80 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { UsageError } from '@struktoai/mirage-core/commands/errors';
+import { IOResult } from '@struktoai/mirage-core/io/types';
+import { yieldBytes } from '@struktoai/mirage-core/io/stream';
+import { HfHubAccessor } from "../../../../accessor/hf_hub.js";
+import { API_SEGMENTS, DEFAULT_REVISION } from "../../../../core/hf_hub/constants.js";
+const DEFAULT_REPO_TYPE = 'model';
+/** The repo kind a line names, defaulting the way upstream does. */
+export function repoTypeOf(fl) {
+    const value = fl.asStr('repo_type') ?? DEFAULT_REPO_TYPE;
+    if (!(value in API_SEGMENTS))
+        throw new UsageError(`invalid repo type: ${value}`);
+    return value;
+}
+/**
+ * A Hub handle for the repository this line named.
+ *
+ * The CLI builds one per invocation rather than owning a second Hub client:
+ * an accessor is a value object here, holding the endpoint, the credential
+ * and which repository is being addressed, so `hf` gets the mount's tree walk
+ * and commit builder for free. It reaches no mount, which is what keeps this
+ * an account CLI.
+ */
+export function hubFor(inv, repoId, repoType, revision) {
+    const config = inv.config;
+    return new HfHubAccessor({
+        repoId,
+        ...(config.token !== undefined ? { token: config.token } : {}),
+        endpoint: config.endpoint,
+        revision: revision === undefined || revision === '' ? DEFAULT_REVISION : revision,
+    }, repoType);
+}
+function result(text, mutated) {
+    const io = mutated === undefined ? new IOResult() : new IOResult({ mutated });
+    return [yieldBytes(new TextEncoder().encode(text)), io];
+}
+/**
+ * Refuse a line that left a required operand empty.
+ *
+ * `Operand.required` is inert outside the clap dialect on purpose: only clap
+ * names the empty slots, and under every other style the refusal stays the
+ * leaf's own business, worded by the command (`executor/command/cli.ts`). hf is
+ * argparse, so each leaf that takes operands calls this, and it words the
+ * refusal the way argparse does rather than letting the line reach the Hub and
+ * come back as an authentication error.
+ */
+export function requireOperands(inv, names) {
+    const missing = names.slice(inv.texts.length);
+    if (missing.length > 0) {
+        throw new UsageError(`the following arguments are required: ${missing.join(', ')}`);
+    }
+}
+export function textOut(text, mutated) {
+    return result(text, mutated);
+}
+/**
+ * Refuse a verb that cannot work anonymously, before it is tried.
+ *
+ * The Hub answers 401 "Invalid username or password." for an unauthenticated
+ * write, which reads as a wrong credential rather than as a missing one.
+ */
+export function requireToken(inv, what) {
+    const config = inv.config;
+    if (config.token === undefined || config.token === '') {
+        throw new UsageError(`${what} requires a token; set \`token\` on the \`hf\` install`);
+    }
+}
+//# sourceMappingURL=accessor.js.map

package/dist/commands/cli/builtin/hf/accessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessor.js","sourceRoot":"","sources":["../../../../../src/commands/cli/builtin/hf/accessor.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAGvE,OAAO,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAA;AAEnE,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAA;AAE7D,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAE9D,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAA;AAErF,MAAM,iBAAiB,GAAG,OAAO,CAAA;AAEjC,oEAAoE;AACpE,MAAM,UAAU,UAAU,CAAC,EAAY;IACrC,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,iBAAiB,CAAA;IACxD,IAAI,CAAC,CAAC,KAAK,IAAI,YAAY,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,sBAAsB,KAAK,EAAE,CAAC,CAAA;IACjF,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,MAAM,CACpB,GAAkB,EAClB,MAAc,EACd,QAAgB,EAChB,QAAiB;IAEjB,MAAM,MAAM,GAAG,GAAG,CAAC,MAAkB,CAAA;IACrC,OAAO,IAAI,aAAa,CACtB;QACE,MAAM;QACN,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,QAAQ,EAAE,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,QAAQ;KAClF,EACD,QAAQ,CACT,CAAA;AACH,CAAC;AAED,SAAS,MAAM,CAAC,IAAY,EAAE,OAAiB;IAC7C,MAAM,EAAE,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC,CAAA;IAC7E,OAAO,CAAC,UAAU,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;AACzD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,GAAkB,EAAE,KAAwB;IAC1E,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC7C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,UAAU,CAAC,yCAAyC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACrF,CAAC;AACH,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,OAAiB;IACrD,OAAO,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;AAC9B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,GAAkB,EAAE,IAAY;IAC3D,MAAM,MAAM,GAAG,GAAG,CAAC,MAAkB,CAAA;IACrC,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,KAAK,EAAE,EAAE,CAAC;QACtD,MAAM,IAAI,UAAU,CAAC,GAAG,IAAI,wDAAwD,CAAC,CAAA;IACvF,CAAC;AACH,CAAC"}

package/dist/commands/cli/builtin/hf/auth.d.ts

@@ -0,0 +1,14 @@
+import type { CLIInvocation } from '@struktoai/mirage-core/commands/cli/types';
+import type { CommandFnResult } from '@struktoai/mirage-core/commands/config';
+/** Print the account the configured token belongs to. */
+export declare function whoamiCmd(inv: CLIInvocation): Promise<CommandFnResult>;
+/**
+ * List the stored access tokens.
+ *
+ * A workspace has no token store: an install carries exactly one credential,
+ * given to it by the embedding program. So this reports that one under
+ * upstream's own two-column shape rather than pretending to a set it cannot
+ * hold, and reports nothing when there is none.
+ */
+export declare function listCmd(inv: CLIInvocation): Promise<CommandFnResult>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/commands/cli/builtin/hf/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../../../src/commands/cli/builtin/hf/auth.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAA;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAA;AAM7E,yDAAyD;AACzD,wBAAsB,SAAS,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,CAqC5E;AAED;;;;;;;GAOG;AACH,wBAAsB,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,CAS1E"}

package/dist/commands/cli/builtin/hf/auth.js

@@ -0,0 +1,77 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { whoami } from "../../../../core/hf_hub/account.js";
+import { API_BASE } from "../../../../core/hf_hub/constants.js";
+import { hfEndpoint } from "../../../../core/hf_hub/config.js";
+import { requireToken, textOut } from "./accessor.js";
+/** Print the account the configured token belongs to. */
+export async function whoamiCmd(inv) {
+    requireToken(inv, 'auth whoami');
+    const account = await whoami(inv.config);
+    const lines = [typeof account.name === 'string' ? account.name : ''];
+    const orgs = account.orgs;
+    const members = [];
+    for (const org of Array.isArray(orgs) ? orgs : []) {
+        if (typeof org === 'object' && org !== null) {
+            const name = org.name;
+            if (typeof name === 'string')
+                members.push(name);
+        }
+    }
+    // `orgs: ` and not a bare line each, which is upstream's shape --
+    // `print(ANSI.bold("orgs: "), ",".join(orgs))` in commands/user.py, whose
+    // two arguments put a second space after the colon. Unlabelled, the account
+    // and the organizations it belongs to are indistinguishable, and a reader
+    // taking the last line pushes to the org instead of the user. Measured: an
+    // agent asked to create a repo under its own account read the org off the
+    // second line and created it there, which the Hub accepts and a grader
+    // looking under the account does not find.
+    //
+    // The escape codes upstream wraps the label in are NOT reproduced. They are
+    // a terminal's, not the command's, and NO_COLOR strips them there too; what
+    // has to match is the word.
+    if (members.length > 0)
+        lines.push(`orgs:  ${members.join(',')}`);
+    // Upstream prints this whenever the endpoint is not huggingface.co, which
+    // for every mirage install is always: the endpoint is the deployment's.
+    //
+    // Read through hfEndpoint and not off the config, because that is what the
+    // REQUEST used: an empty endpoint means the public Hub there, and comparing
+    // the raw value would announce a private endpoint with no origin after it
+    // for a request that went to huggingface.co.
+    const endpoint = hfEndpoint(inv.config).replace(/\/+$/, '');
+    if (endpoint !== API_BASE) {
+        lines.push(`Authenticated through private endpoint: ${endpoint}`);
+    }
+    return textOut(`${lines.join('\n')}\n`);
+}
+/**
+ * List the stored access tokens.
+ *
+ * A workspace has no token store: an install carries exactly one credential,
+ * given to it by the embedding program. So this reports that one under
+ * upstream's own two-column shape rather than pretending to a set it cannot
+ * hold, and reports nothing when there is none.
+ */
+export async function listCmd(inv) {
+    const config = inv.config;
+    const rows = ['NAME'.padEnd(20) + ' ' + 'TOKEN'];
+    if (config.token !== undefined && config.token !== '') {
+        const account = await whoami(config);
+        const name = typeof account.name === 'string' ? account.name : 'install';
+        rows.push(name.padEnd(20) + ' ' + '*'.repeat(8));
+    }
+    return textOut(`${rows.join('\n')}\n`);
+}
+//# sourceMappingURL=auth.js.map

package/dist/commands/cli/builtin/hf/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../../../src/commands/cli/builtin/hf/auth.ts"],"names":[],"mappings":"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"}

package/dist/commands/cli/builtin/hf/download.d.ts

@@ -0,0 +1,46 @@
+import type { CLIInvocation } from '@struktoai/mirage-core/commands/cli/types';
+import type { CommandFnResult } from '@struktoai/mirage-core/commands/config';
+import type { DispatchFn } from '@struktoai/mirage-core/runtime/types';
+import { type TreeEntry } from '../../../../core/hf_hub/tree_entry.ts';
+/**
+ * Which repo paths a download line asks for.
+ *
+ * Named files win outright: upstream downloads exactly those and does not then
+ * filter them, so --include only ever narrows a whole-repo download.
+ */
+export declare function selected(tree: Map<string, TreeEntry>, names: readonly string[], include: readonly string[], exclude: readonly string[]): string[];
+/**
+ * Create a directory and every missing directory above it.
+ *
+ * Written out rather than delegated to `mkdir -p` because the parents flag is
+ * a per-backend capability: the ops factory only wires `parents: true` for
+ * backends that declare it, so a plain `mkdir` of `a/b` fails on the rest.
+ */
+export declare function ensureDir(dispatch: DispatchFn, path: string): Promise<void>;
+/**
+ * Refuse a line written in upstream's variadic option form.
+ *
+ * Upstream declares --include and --exclude as `nargs='*'`, so
+ * `--include "*.json" "*.txt"` gives both patterns to the flag. mirage's
+ * grammar has no variadic option value (POSIX presents multiple
+ * option-arguments as one argument, so the spec layer has no shape for it),
+ * and the second word lands as a filename operand instead. Since named files
+ * win outright, that line would silently look for a file literally called
+ * `*.txt` and report no match, so it is refused with the spelling that works.
+ *
+ * `patterns` is what the option itself received, so the message can show the
+ * whole line rewritten rather than the stray word twice.
+ */
+export declare function refuseVariadic(names: readonly string[], flag: string, patterns: readonly string[]): void;
+/**
+ * Download files from a repository into the workspace.
+ *
+ * Upstream defaults to `~/.cache/huggingface`, which a workspace has no
+ * equivalent of, so `--local-dir` is required rather than silently resolving
+ * to a directory outside the agent's world. Downloading is also the one verb
+ * the mount does better -- `cp /m/config.json .` reads the same bytes without
+ * a second copy -- so this exists for the repository a workspace has not
+ * mounted.
+ */
+export declare function downloadCmd(inv: CLIInvocation): Promise<CommandFnResult>;
+//# sourceMappingURL=download.d.ts.map

package/dist/commands/cli/builtin/hf/download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../../../../src/commands/cli/builtin/hf/download.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAA;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAA;AAG7E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAA;AAoBtE,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,uCAAuC,CAAA;AAIlF;;;;;GAKG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,EAC5B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,MAAM,EAAE,CAgBV;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBjF;AAsHD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,IAAI,CAQN;AAuED;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,CAgD9E"}