@allyhub/sdk 0.1.0-alpha.8 → 0.2.0-next.0

package/node_modules/@allyhub-next/protocol/dist/cli.d.ts

@@ -0,0 +1,59 @@
+import { z } from "zod";
+/** Exit codes: 0 is success; each other is one kind of failure. */
+export declare const EXIT: {
+    readonly ok: 0;
+    /** It ran and failed, or found problems (a check). */
+    readonly failed: 1;
+    /** It was asked wrongly: an unknown option, an invalid value. */
+    readonly usage: 2;
+    /** A file changed under it, or a place is taken. */
+    readonly conflict: 3;
+    /** It needs a sign-in, or the account may not. */
+    readonly auth: 4;
+    /** Something this computer lacks: a tool, a runtime, a permission. */
+    readonly platform: 5;
+    readonly notFound: 6;
+    /** Stopped by the person (SIGINT). */
+    readonly interrupted: 130;
+};
+export type ExitCode = (typeof EXIT)[keyof typeof EXIT];
+/** A failure as --json prints it, on stdout, with the exit code. */
+export declare const CliErrorSchema: z.ZodObject<{
+    error: z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        hint: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type CliError = z.infer<typeof CliErrorSchema>;
+/** A command's name: words in lowercase, `scenery view`. */
+export declare const COMMAND_NAME: RegExp;
+export interface CommandSpec<I extends z.ZodObject = z.ZodObject, O extends z.ZodType = z.ZodType> {
+    name: string;
+    /** One line, for the list. */
+    summary: string;
+    /** Arguments and options, each field described; a field in `positional` is an argument. */
+    input: I;
+    /** Fields of `input` given by position, in order. */
+    positional?: readonly (keyof z.infer<I> & string)[];
+    /** What --json prints on success. */
+    output: O;
+    /** Lines of `allyhub help <command>` that show it at work. */
+    examples?: readonly string[];
+    /** Exposed as an MCP tool by `allyhub mcp` (most are; one that talks to a terminal is not). */
+    mcp?: boolean;
+}
+/** A command's spec, checked: its name's form, and that each positional is a field. */
+export declare function command<I extends z.ZodObject, O extends z.ZodType>(spec: CommandSpec<I, O>): CommandSpec<I, O>;
+/** A command as data: what `allyhub help --json` and an MCP tool listing give. */
+export declare function describeCommand(spec: CommandSpec): {
+    name: string;
+    summary: string;
+    positional: string[];
+    input: Record<string, unknown>;
+    output: Record<string, unknown>;
+    examples: string[];
+};
+/** The MCP tool name of a command: `scenery view` is `allyhub_scenery_view`. */
+export declare const toolName: (name: string) => string;
+//# sourceMappingURL=cli.d.ts.map

package/node_modules/@allyhub-next/protocol/dist/cli.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{z as o}from"zod";export const EXIT={ok:0,failed:1,usage:2,conflict:3,auth:4,platform:5,notFound:6,interrupted:130},CliErrorSchema=o.strictObject({error:o.strictObject({code:o.string().regex(/^[a-z][a-z0-9-]*$/u),message:o.string().min(1),hint:o.string().optional()})}),COMMAND_NAME=/^[a-z][a-z0-9-]*(?: [a-z][a-z0-9-]*)*$/u;export function command(t){if(!COMMAND_NAME.test(t.name))throw new Error(`"${t.name}" is not a command name.`);const e=Object.keys(t.input.shape);for(const n of t.positional??[])if(!e.includes(n))throw new Error(`${t.name}: positional "${n}" is not a field of its input.`);for(const[n,r]of Object.entries(t.input.shape))if(!r.description)throw new Error(`${t.name}: "${n}" has no description.`);return t}export function describeCommand(t){return{name:t.name,summary:t.summary,positional:[...t.positional??[]],input:o.toJSONSchema(t.input,{io:"input",unrepresentable:"any"}),output:o.toJSONSchema(t.output,{io:"output",unrepresentable:"any"}),examples:[...t.examples??[]]}}export const toolName=t=>`allyhub_${t.replaceAll(/[ -]/gu,"_")}`;

package/node_modules/@allyhub-next/protocol/dist/cloud.d.ts

@@ -0,0 +1,272 @@
+import { z } from "zod";
+/** The environment variable that signs in with an API key instead: automation (CI, servers). */
+export declare const API_KEY_ENV = "ALLYHUB_API_KEY";
+/** `GET`: the organization's credits, its plan and its auto top-up. */
+export declare const BILLING_SUMMARY_PATH = "/api/billing/summary";
+export declare const BillingSummarySchema: z.ZodObject<{
+    credits: z.ZodNumber;
+    held: z.ZodNumber;
+    owed: z.ZodNumber;
+    plan: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        interval: z.ZodEnum<{
+            month: "month";
+            year: "year";
+        }>;
+        status: z.ZodString;
+        renewsAt: z.ZodNullable<z.ZodISODateTime>;
+        endsAt: z.ZodNullable<z.ZodISODateTime>;
+    }, z.core.$strip>>;
+    autoTopUp: z.ZodNullable<z.ZodObject<{
+        below: z.ZodNumber;
+        amountCents: z.ZodNumber;
+        stopped: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type BillingSummary = z.infer<typeof BillingSummarySchema>;
+/** `GET`, open to anyone: the plans offered and their prices, and what a top-up buys. */
+export declare const BILLING_PLANS_PATH = "/api/billing/plans";
+export declare const BillingPlansSchema: z.ZodObject<{
+    plans: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        monthlyCredits: z.ZodNumber;
+        prices: z.ZodArray<z.ZodObject<{
+            interval: z.ZodEnum<{
+                month: "month";
+                year: "year";
+            }>;
+            amountCents: z.ZodNumber;
+            currency: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    topUp: z.ZodObject<{
+        currency: z.ZodString;
+        creditsPerDollar: z.ZodNumber;
+        minCents: z.ZodNumber;
+        maxCents: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type BillingPlans = z.infer<typeof BillingPlansSchema>;
+/** `GET ?days=30&timeZone=Asia/Shanghai`: credits spent each day, the days with none left out. */
+export declare const BILLING_USAGE_PATH = "/api/billing/usage";
+export declare const BillingUsageSchema: z.ZodObject<{
+    days: z.ZodArray<z.ZodObject<{
+        day: z.ZodISODate;
+        credits: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type BillingUsage = z.infer<typeof BillingUsageSchema>;
+/** `POST`, an owner's or an admin's: Stripe Checkout for a plan or a top-up; answers `{ url }`. */
+export declare const BILLING_CHECKOUT_PATH = "/api/billing/checkout";
+export declare const CheckoutRequestSchema: z.ZodUnion<readonly [z.ZodObject<{
+    plan: z.ZodString;
+    interval: z.ZodEnum<{
+        month: "month";
+        year: "year";
+    }>;
+}, z.core.$strict>, z.ZodObject<{
+    topUpCents: z.ZodNumber;
+}, z.core.$strict>]>;
+/** `POST`, an owner's or an admin's: Stripe's Customer Portal (change or cancel the plan, the card, invoices); answers `{ url }`. */
+export declare const BILLING_PORTAL_PATH = "/api/billing/portal";
+/**
+ * `PUT { below, amountCents }`, an owner's or an admin's: auto top-up on,
+ * answered `{ on: true }`, or `{ saveCard: url }`, a Checkout that saves a
+ * card first; `DELETE` turns it off.
+ */
+export declare const AUTO_TOP_UP_PATH = "/api/billing/auto-top-up";
+export declare const AutoTopUpRequestSchema: z.ZodObject<{
+    below: z.ZodNumber;
+    amountCents: z.ZodNumber;
+}, z.core.$strict>;
+/** The plan page; `view` opens the plans, or the overview with a top-up. */
+export declare const BILLING_PAGE_PATH = "/plan";
+/** Where Stripe's Checkout lands once paid: a page that embeds the plan page may close then. */
+export declare const BILLING_PAID_PATH = "/plan/paid";
+/** `view` on the plan page: the plans, or the overview with the top-up open. */
+export declare const BILLING_VIEWS: {
+    readonly plans: "plans";
+    readonly credits: "add-credits";
+};
+/** The language the app shows, which the page shows too (a locale code, `zh-cn`). */
+export declare const BILLING_LANG_PARAM = "lang";
+/** The models the organization may use. */
+export declare const LLM_MODELS_PATH = "/api/llm/models";
+/** Anthropic's Messages API (`POST`), streamed or not. */
+export declare const LLM_MESSAGES_PATH = "/api/llm/v1/messages";
+export declare const ModelCatalogSchema: z.ZodObject<{
+    models: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        reasoning: z.ZodOptional<z.ZodBoolean>;
+        input: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        contextWindow: z.ZodOptional<z.ZodNumber>;
+        maxOutput: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$loose>>;
+    defaultModel: z.ZodString;
+}, z.core.$strip>;
+export type ModelCatalog = z.infer<typeof ModelCatalogSchema>;
+/** A JSON Schema document of a tool's input or output. */
+export declare const JsonSchemaSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+/**
+ * One part of a tool's price rule: `credits` per unit of `meter` (per
+ * `tiers[input[tierField]]` when the input picks a tier), beyond `free`
+ * units. Meters that read the input (`input_count`, `input_block`,
+ * `input_value`) count `field`; the others count what the run returned
+ * (results, seconds, images…), estimated from `field` or `typical`.
+ * Meters are plain strings: the server may add new ones.
+ */
+export declare const ToolPricePartSchema: z.ZodObject<{
+    meter: z.ZodString;
+    credits: z.ZodNumber;
+    field: z.ZodOptional<z.ZodString>;
+    size: z.ZodOptional<z.ZodNumber>;
+    free: z.ZodOptional<z.ZodNumber>;
+    tierField: z.ZodOptional<z.ZodString>;
+    tiers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    typical: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type ToolPricePart = z.infer<typeof ToolPricePartSchema>;
+/** What a run is charged, in credits: the base plus each part. */
+export declare const ToolPriceSchema: z.ZodObject<{
+    baseCredits: z.ZodNumber;
+    parts: z.ZodArray<z.ZodObject<{
+        meter: z.ZodString;
+        credits: z.ZodNumber;
+        field: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodNumber>;
+        free: z.ZodOptional<z.ZodNumber>;
+        tierField: z.ZodOptional<z.ZodString>;
+        tiers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        typical: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ToolPrice = z.infer<typeof ToolPriceSchema>;
+export declare const CATALOG_PATH = "/api/catalog";
+export declare const CatalogWorkSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+}, z.core.$strip>;
+export type CatalogWork = z.infer<typeof CatalogWorkSchema>;
+export declare const CatalogToolSchema: z.ZodObject<{
+    name: z.ZodString;
+    work: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    output: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    price: z.ZodObject<{
+        baseCredits: z.ZodNumber;
+        parts: z.ZodArray<z.ZodObject<{
+            meter: z.ZodString;
+            credits: z.ZodNumber;
+            field: z.ZodOptional<z.ZodString>;
+            size: z.ZodOptional<z.ZodNumber>;
+            free: z.ZodOptional<z.ZodNumber>;
+            tierField: z.ZodOptional<z.ZodString>;
+            tiers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+            typical: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    long: z.ZodBoolean;
+}, z.core.$strip>;
+export type CatalogTool = z.infer<typeof CatalogToolSchema>;
+export declare const CatalogSchema: z.ZodObject<{
+    version: z.ZodString;
+    works: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodString;
+    }, z.core.$strip>>;
+    tools: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        work: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodString;
+        input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        output: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        price: z.ZodObject<{
+            baseCredits: z.ZodNumber;
+            parts: z.ZodArray<z.ZodObject<{
+                meter: z.ZodString;
+                credits: z.ZodNumber;
+                field: z.ZodOptional<z.ZodString>;
+                size: z.ZodOptional<z.ZodNumber>;
+                free: z.ZodOptional<z.ZodNumber>;
+                tierField: z.ZodOptional<z.ZodString>;
+                tiers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+                typical: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        long: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Catalog = z.infer<typeof CatalogSchema>;
+/** Where a tool's calls are made (POST). */
+export declare const toolCallsPath: (tool: string) => string;
+/** Where a call is read again (GET). */
+export declare const callPath: (id: string) => string;
+export declare const ToolCallRequestSchema: z.ZodObject<{
+    input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strict>;
+export type ToolCallRequest = z.infer<typeof ToolCallRequestSchema>;
+export declare const CALL_STATUS: readonly ["working", "completed", "failed"];
+export declare const ToolCallSchema: z.ZodObject<{
+    id: z.ZodString;
+    tool: z.ZodString;
+    status: z.ZodEnum<{
+        failed: "failed";
+        working: "working";
+        completed: "completed";
+    }>;
+    output: z.ZodOptional<z.ZodUnknown>;
+    error: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodString;
+        message: z.ZodString;
+    }, z.core.$strip>>;
+    credits: z.ZodOptional<z.ZodNumber>;
+    pollAfterMs: z.ZodOptional<z.ZodNumber>;
+    createdAt: z.ZodString;
+    endedAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ToolCall = z.infer<typeof ToolCallSchema>;
+/** The file an in-app path points at, or undefined. */
+export declare function parseAllyFilePath(path: string): {
+    id: string;
+    name: string;
+} | undefined;
+/** The largest file kept, in bytes. */
+export declare const FILE_MAX_BYTES: number;
+/** `POST { name, size, sha256, contentType }`: a file to keep; answers its id and where to put its bytes, or no `upload` when it is kept already. */
+export declare const FILES_PATH = "/api/files";
+export declare const FileCreateRequestSchema: z.ZodObject<{
+    name: z.ZodString;
+    size: z.ZodInt;
+    sha256: z.ZodString;
+    contentType: z.ZodString;
+}, z.core.$strict>;
+export type FileCreateRequest = z.infer<typeof FileCreateRequestSchema>;
+export declare const FileCreatedSchema: z.ZodObject<{
+    id: z.ZodString;
+    upload: z.ZodNullable<z.ZodObject<{
+        url: z.ZodURL;
+        headers: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type FileCreated = z.infer<typeof FileCreatedSchema>;
+/** `POST`: the bytes are put; answers the file once storage has them as asked. */
+export declare const fileDonePath: (fileId: string) => string;
+export declare const UploadedFileSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+}, z.core.$strip>;
+/** `GET <api>/api/files/<fileId>/content?disposition=…`: a signed URL. */
+export declare const FileContentResponseSchema: z.ZodObject<{
+    url: z.ZodURL;
+}, z.core.$strip>;
+/** The path of a file's signed URL: a download, or shown inline (for a provider to fetch). */
+export declare const fileContentPath: (fileId: string, disposition: "attachment" | "inline") => string;
+//# sourceMappingURL=cloud.d.ts.map

package/node_modules/@allyhub-next/protocol/dist/cloud.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{z as t}from"zod";export const API_KEY_ENV="ALLYHUB_API_KEY",BILLING_SUMMARY_PATH="/api/billing/summary",BillingSummarySchema=t.object({credits:t.number(),held:t.number(),owed:t.number(),plan:t.object({id:t.string(),name:t.string(),interval:t.enum(["month","year"]),status:t.string(),renewsAt:t.iso.datetime().nullable(),endsAt:t.iso.datetime().nullable()}).nullable(),autoTopUp:t.object({below:t.number(),amountCents:t.number(),stopped:t.string().nullable()}).nullable()}),BILLING_PLANS_PATH="/api/billing/plans",BillingPlansSchema=t.object({plans:t.array(t.object({id:t.string(),name:t.string(),monthlyCredits:t.number(),prices:t.array(t.object({interval:t.enum(["month","year"]),amountCents:t.number(),currency:t.string()}))})),topUp:t.object({currency:t.string(),creditsPerDollar:t.number(),minCents:t.number(),maxCents:t.number()})}),BILLING_USAGE_PATH="/api/billing/usage",BillingUsageSchema=t.object({days:t.array(t.object({day:t.iso.date(),credits:t.number()}))}),BILLING_CHECKOUT_PATH="/api/billing/checkout",CheckoutRequestSchema=t.union([t.strictObject({plan:t.string(),interval:t.enum(["month","year"])}),t.strictObject({topUpCents:t.number().int()})]),BILLING_PORTAL_PATH="/api/billing/portal",AUTO_TOP_UP_PATH="/api/billing/auto-top-up",AutoTopUpRequestSchema=t.strictObject({below:t.number().nonnegative(),amountCents:t.number().int().positive()}),BILLING_PAGE_PATH="/plan",BILLING_PAID_PATH="/plan/paid",BILLING_VIEWS={plans:"plans",credits:"add-credits"},BILLING_LANG_PARAM="lang",LLM_MODELS_PATH="/api/llm/models",LLM_MESSAGES_PATH="/api/llm/v1/messages",ModelCatalogSchema=t.object({models:t.array(t.looseObject({id:t.string().min(1),name:t.string().min(1),reasoning:t.boolean().optional(),input:t.array(t.string()).optional(),contextWindow:t.number().int().positive().optional(),maxOutput:t.number().int().positive().optional()})).min(1),defaultModel:t.string().min(1)}),JsonSchemaSchema=t.record(t.string(),t.unknown()),ToolPricePartSchema=t.object({meter:t.string().min(1),credits:t.number().nonnegative(),field:t.string().optional(),size:t.number().int().positive().optional(),free:t.number().int().nonnegative().optional(),tierField:t.string().optional(),tiers:t.record(t.string(),t.number().nonnegative()).optional(),typical:t.number().nonnegative().optional()}),ToolPriceSchema=t.object({baseCredits:t.number().nonnegative(),parts:t.array(ToolPricePartSchema)}),CATALOG_PATH="/api/catalog",CatalogWorkSchema=t.object({id:t.string().min(1),title:t.string().min(1),description:t.string().min(1)}),CatalogToolSchema=t.object({name:t.string().min(1),work:t.string().min(1),title:t.string().min(1),description:t.string().min(1),input:JsonSchemaSchema,output:JsonSchemaSchema,price:ToolPriceSchema,long:t.boolean()}),CatalogSchema=t.object({version:t.string().min(1),works:t.array(CatalogWorkSchema),tools:t.array(CatalogToolSchema)}),toolCallsPath=e=>`/api/tools/${encodeURIComponent(e)}/calls`,callPath=e=>`/api/calls/${encodeURIComponent(e)}`,ToolCallRequestSchema=t.strictObject({input:t.record(t.string(),t.unknown())}),CALL_STATUS=["working","completed","failed"],ToolCallSchema=t.object({id:t.string().min(1),tool:t.string().min(1),status:t.enum(CALL_STATUS),output:t.unknown().optional(),error:t.object({kind:t.string().min(1),message:t.string().min(1)}).optional(),credits:t.number().nonnegative().optional(),pollAfterMs:t.number().int().nonnegative().optional(),createdAt:t.string(),endedAt:t.string().optional()});const i="ally://data-tool-results/";export function parseAllyFilePath(e){if(!e.startsWith(i))return;const[n,o,...r]=e.slice(i.length).split("/");if(!(!n||!o||r.length>0))try{return{id:decodeURIComponent(n),name:decodeURIComponent(o)}}catch{return}}export const FILE_MAX_BYTES=1024*1024*1024,FILES_PATH="/api/files",FileCreateRequestSchema=t.strictObject({name:t.string().min(1).max(255),size:t.int().positive().max(FILE_MAX_BYTES),sha256:t.string().regex(/^[0-9a-f]{64}$/u),contentType:t.string().min(1).max(255)}),FileCreatedSchema=t.object({id:t.string().min(1),upload:t.object({url:t.url(),headers:t.record(t.string(),t.string())}).nullable()}),fileDonePath=e=>`${FILES_PATH}/${encodeURIComponent(e)}/done`,UploadedFileSchema=t.object({id:t.string().min(1),name:t.string()}),FileContentResponseSchema=t.object({url:t.url()}),fileContentPath=(e,n)=>`${FILES_PATH}/${encodeURIComponent(e)}/content?disposition=${n}`;