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

package/node_modules/@allyhub-next/formats/schemas/sheet.schema.json

@@ -0,0 +1,395 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://allyhub.com/schemas/sheet.schema.json",
+  "title": "sheet",
+  "description": "What a sheet's columns are.",
+  "anyOf": [
+    {
+      "type": "null"
+    },
+    {
+      "type": "object",
+      "properties": {
+        "title": {
+          "type": [
+            "string",
+            "number"
+          ]
+        },
+        "key": {
+          "type": "string",
+          "pattern": "\\S"
+        },
+        "primary": {
+          "type": "string",
+          "pattern": "\\S"
+        },
+        "columns": {
+          "anyOf": [
+            {
+              "type": "null"
+            },
+            {
+              "type": "object",
+              "propertyNames": {
+                "type": "string"
+              },
+              "additionalProperties": {
+                "anyOf": [
+                  {
+                    "type": "null"
+                  },
+                  {
+                    "type": "string",
+                    "enum": [
+                      "text",
+                      "number",
+                      "select",
+                      "multi-select",
+                      "date",
+                      "checkbox",
+                      "url",
+                      "email",
+                      "phone",
+                      "file"
+                    ]
+                  },
+                  {
+                    "anyOf": [
+                      {
+                        "type": "object",
+                        "properties": {
+                          "type": {
+                            "anyOf": [
+                              {
+                                "type": "string",
+                                "enum": [
+                                  "text",
+                                  "checkbox",
+                                  "url",
+                                  "email",
+                                  "phone"
+                                ]
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          },
+                          "width": {
+                            "type": "number",
+                            "exclusiveMinimum": 0
+                          },
+                          "wrap": {
+                            "type": "boolean"
+                          }
+                        },
+                        "additionalProperties": false
+                      },
+                      {
+                        "type": "object",
+                        "properties": {
+                          "type": {
+                            "type": "string",
+                            "const": "number"
+                          },
+                          "format": {
+                            "anyOf": [
+                              {
+                                "type": "string",
+                                "enum": [
+                                  "plain",
+                                  "percent",
+                                  "currency"
+                                ]
+                              },
+                              {
+                                "type": "object",
+                                "properties": {
+                                  "style": {
+                                    "anyOf": [
+                                      {
+                                        "type": "string",
+                                        "enum": [
+                                          "plain",
+                                          "percent",
+                                          "currency"
+                                        ]
+                                      },
+                                      {
+                                        "type": "null"
+                                      }
+                                    ]
+                                  },
+                                  "decimals": {
+                                    "type": "integer",
+                                    "minimum": 0,
+                                    "maximum": 10
+                                  },
+                                  "currency": {
+                                    "type": "string",
+                                    "pattern": "^[A-Za-z]{3}$"
+                                  },
+                                  "thousands": {
+                                    "type": "boolean"
+                                  }
+                                },
+                                "additionalProperties": false
+                              }
+                            ]
+                          },
+                          "width": {
+                            "type": "number",
+                            "exclusiveMinimum": 0
+                          },
+                          "wrap": {
+                            "type": "boolean"
+                          }
+                        },
+                        "required": [
+                          "type"
+                        ],
+                        "additionalProperties": false
+                      },
+                      {
+                        "type": "object",
+                        "properties": {
+                          "type": {
+                            "type": "string",
+                            "const": "date"
+                          },
+                          "format": {
+                            "anyOf": [
+                              {
+                                "type": "string",
+                                "enum": [
+                                  "iso",
+                                  "short",
+                                  "long"
+                                ]
+                              },
+                              {
+                                "type": "object",
+                                "properties": {
+                                  "style": {
+                                    "anyOf": [
+                                      {
+                                        "type": "string",
+                                        "enum": [
+                                          "iso",
+                                          "short",
+                                          "long"
+                                        ]
+                                      },
+                                      {
+                                        "type": "null"
+                                      }
+                                    ]
+                                  },
+                                  "time": {
+                                    "type": "boolean"
+                                  }
+                                },
+                                "additionalProperties": false
+                              }
+                            ]
+                          },
+                          "width": {
+                            "type": "number",
+                            "exclusiveMinimum": 0
+                          },
+                          "wrap": {
+                            "type": "boolean"
+                          }
+                        },
+                        "required": [
+                          "type"
+                        ],
+                        "additionalProperties": false
+                      },
+                      {
+                        "type": "object",
+                        "properties": {
+                          "type": {
+                            "type": "string",
+                            "const": "select"
+                          },
+                          "options": {
+                            "type": "array",
+                            "items": {
+                              "anyOf": [
+                                {
+                                  "type": "string",
+                                  "pattern": "\\S"
+                                },
+                                {
+                                  "type": "number"
+                                },
+                                {
+                                  "type": "boolean"
+                                },
+                                {
+                                  "type": "object",
+                                  "properties": {
+                                    "name": {
+                                      "anyOf": [
+                                        {
+                                          "type": "string",
+                                          "pattern": "\\S"
+                                        },
+                                        {
+                                          "type": "number"
+                                        }
+                                      ]
+                                    },
+                                    "color": {
+                                      "type": "string",
+                                      "enum": [
+                                        "gray",
+                                        "brown",
+                                        "red",
+                                        "orange",
+                                        "yellow",
+                                        "green",
+                                        "blue",
+                                        "purple",
+                                        "pink"
+                                      ]
+                                    }
+                                  },
+                                  "required": [
+                                    "name"
+                                  ],
+                                  "additionalProperties": false
+                                }
+                              ]
+                            }
+                          },
+                          "width": {
+                            "type": "number",
+                            "exclusiveMinimum": 0
+                          },
+                          "wrap": {
+                            "type": "boolean"
+                          }
+                        },
+                        "required": [
+                          "type"
+                        ],
+                        "additionalProperties": false
+                      },
+                      {
+                        "type": "object",
+                        "properties": {
+                          "type": {
+                            "type": "string",
+                            "const": "multi-select"
+                          },
+                          "options": {
+                            "type": "array",
+                            "items": {
+                              "anyOf": [
+                                {
+                                  "type": "string",
+                                  "pattern": "\\S"
+                                },
+                                {
+                                  "type": "number"
+                                },
+                                {
+                                  "type": "boolean"
+                                },
+                                {
+                                  "type": "object",
+                                  "properties": {
+                                    "name": {
+                                      "anyOf": [
+                                        {
+                                          "type": "string",
+                                          "pattern": "\\S"
+                                        },
+                                        {
+                                          "type": "number"
+                                        }
+                                      ]
+                                    },
+                                    "color": {
+                                      "type": "string",
+                                      "enum": [
+                                        "gray",
+                                        "brown",
+                                        "red",
+                                        "orange",
+                                        "yellow",
+                                        "green",
+                                        "blue",
+                                        "purple",
+                                        "pink"
+                                      ]
+                                    }
+                                  },
+                                  "required": [
+                                    "name"
+                                  ],
+                                  "additionalProperties": false
+                                }
+                              ]
+                            }
+                          },
+                          "separator": {
+                            "type": "string",
+                            "pattern": "^[^\"]*[^\"\\s][^\"]*$"
+                          },
+                          "width": {
+                            "type": "number",
+                            "exclusiveMinimum": 0
+                          },
+                          "wrap": {
+                            "type": "boolean"
+                          }
+                        },
+                        "required": [
+                          "type"
+                        ],
+                        "additionalProperties": false
+                      },
+                      {
+                        "type": "object",
+                        "properties": {
+                          "type": {
+                            "type": "string",
+                            "const": "file"
+                          },
+                          "separator": {
+                            "type": "string",
+                            "pattern": "^[^\"]*[^\"\\s][^\"]*$"
+                          },
+                          "height": {
+                            "type": "number",
+                            "exclusiveMinimum": 0
+                          },
+                          "width": {
+                            "type": "number",
+                            "exclusiveMinimum": 0
+                          },
+                          "wrap": {
+                            "type": "boolean"
+                          }
+                        },
+                        "required": [
+                          "type"
+                        ],
+                        "additionalProperties": false
+                      }
+                    ]
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      },
+      "additionalProperties": false
+    }
+  ]
+}

package/node_modules/@allyhub-next/formats/schemas/words.schema.json

@@ -0,0 +1,63 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://allyhub.com/schemas/words.schema.json",
+  "title": "words",
+  "description": "The words said in an audio or video file, with their times.",
+  "type": "object",
+  "properties": {
+    "$schema": {
+      "type": "string"
+    },
+    "version": {
+      "type": "number",
+      "const": 1
+    },
+    "language": {
+      "type": "string",
+      "minLength": 2
+    },
+    "duration": {
+      "type": "number",
+      "minimum": 0
+    },
+    "model": {
+      "type": "string"
+    },
+    "words": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "text": {
+            "type": "string",
+            "minLength": 1
+          },
+          "start": {
+            "type": "number",
+            "minimum": 0
+          },
+          "end": {
+            "type": "number",
+            "minimum": 0
+          },
+          "confidence": {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 1
+          }
+        },
+        "required": [
+          "text",
+          "start",
+          "end"
+        ],
+        "additionalProperties": false
+      }
+    }
+  },
+  "required": [
+    "version",
+    "words"
+  ],
+  "additionalProperties": false
+}

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

@@ -0,0 +1,98 @@
+import { z } from "zod";
+/** The tool the model calls to show an item. */
+export declare const OPEN_TOOL = "allyhub_open";
+/** The card's resource. */
+export declare const CARD_RESOURCE = "ui://allyhub/card";
+/** Where the tool result's `_meta` holds the card whole. */
+export declare const CARD_META = "allyhub/card";
+/** `allyhub_open`'s input. */
+export declare const OpenInputSchema: z.ZodObject<{
+    path: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/** What the card shows of an item, made from its files when it is opened. */
+export declare const PreviewSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"picture">;
+    image: z.ZodObject<{
+        mime: z.ZodString;
+        data: z.ZodBase64;
+    }, z.core.$strict>;
+    width: z.ZodInt;
+    height: z.ZodInt;
+    duration: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    lines: z.ZodArray<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"table">;
+    columns: z.ZodArray<z.ZodString>;
+    rows: z.ZodArray<z.ZodArray<z.ZodString>>;
+    count: z.ZodInt;
+}, z.core.$strict>], "type">;
+export type Preview = z.infer<typeof PreviewSchema>;
+export declare const CardItemSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        video: "video";
+        slides: "slides";
+        doc: "doc";
+        sheet: "sheet";
+        scenery: "scenery";
+        website: "website";
+    }>;
+    dir: z.ZodString;
+    entry: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type CardItem = z.infer<typeof CardItemSchema>;
+/** `allyhub_open`'s structured result: what the card shows. */
+export declare const CardSchema: z.ZodObject<{
+    project: z.ZodObject<{
+        name: z.ZodString;
+    }, z.core.$strict>;
+    url: z.ZodString;
+    item: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodEnum<{
+            video: "video";
+            slides: "slides";
+            doc: "doc";
+            sheet: "sheet";
+            scenery: "scenery";
+            website: "website";
+        }>;
+        dir: z.ZodString;
+        entry: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    preview: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"picture">;
+        image: z.ZodObject<{
+            mime: z.ZodString;
+            data: z.ZodBase64;
+        }, z.core.$strict>;
+        width: z.ZodInt;
+        height: z.ZodInt;
+        duration: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        lines: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"table">;
+        columns: z.ZodArray<z.ZodString>;
+        rows: z.ZodArray<z.ZodArray<z.ZodString>>;
+        count: z.ZodInt;
+    }, z.core.$strict>], "type">>;
+    items: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            video: "video";
+            slides: "slides";
+            doc: "doc";
+            sheet: "sheet";
+            scenery: "scenery";
+            website: "website";
+        }>;
+        dir: z.ZodString;
+        entry: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type Card = z.infer<typeof CardSchema>;
+//# sourceMappingURL=app.d.ts.map

package/node_modules/@allyhub-next/protocol/dist/app.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";import{KINDS as r}from"@allyhub-next/formats";import{PathSchema as e}from"./files.js";import{ImageSchema as i}from"./tools.js";export const OPEN_TOOL="allyhub_open",CARD_RESOURCE="ui://allyhub/card",CARD_META="allyhub/card",OpenInputSchema=t.strictObject({path:t.string().min(1).optional().describe("The item to open: its folder or entry file, absolute or from the folder allyhub mcp runs in (launch/plan, launch/plan/doc.mdx); leave it out for the project's items")}),PreviewSchema=t.discriminatedUnion("type",[t.strictObject({type:t.literal("picture"),image:i,width:t.int().positive(),height:t.int().positive(),duration:t.number().nonnegative().optional()}),t.strictObject({type:t.literal("text"),lines:t.array(t.string())}),t.strictObject({type:t.literal("table"),columns:t.array(t.string()),rows:t.array(t.array(t.string())),count:t.int().nonnegative()})]),CardItemSchema=t.strictObject({kind:t.enum(r),dir:e,entry:e,title:t.string().optional()}),CardSchema=t.strictObject({project:t.strictObject({name:t.string().min(1)}),url:t.string().min(1),item:CardItemSchema.optional(),preview:PreviewSchema.optional(),items:t.array(CardItemSchema).optional()});

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

@@ -0,0 +1,116 @@
+import { z } from "zod";
+/** The authorization server's metadata AllyHub uses (RFC 8414). */
+export declare const AuthServerSchema: z.ZodObject<{
+    issuer: z.ZodURL;
+    authorization_endpoint: z.ZodURL;
+    token_endpoint: z.ZodURL;
+    device_authorization_endpoint: z.ZodURL;
+    revocation_endpoint: z.ZodURL;
+    code_challenge_methods_supported: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type AuthServer = z.infer<typeof AuthServerSchema>;
+/** The public client the CLI signs in as. */
+export declare const CLIENT_ID = "allyhub-cli";
+/** The issuer's path on the API's origin: Better Auth's routes. */
+export declare const ISSUER_PATH = "/api/auth";
+/** Where the issuer's metadata is (RFC 8414: the origin's well-known path, then the issuer's). */
+export declare const METADATA_PATH = "/.well-known/oauth-authorization-server/api/auth";
+/** What the CLI asks for: who the person is, and a refresh token. */
+export declare const SCOPES = "openid profile email offline_access";
+/** `GET <url>…`: who a credential is, and the organization it acts in. */
+export declare const ACCOUNT_PATH = "/api/account";
+/** The header that names the organization a request acts in; without it, the person's own. */
+export declare const ORGANIZATION_HEADER = "x-allyhub-organization";
+/** Where a person sees and signs out the computers signed in as them, on the web. */
+export declare const DEVICES_PAGE_PATH = "/devices";
+/** `GET`: the computers signed in as the person (a session's alone); `DELETE <path>/<id>` signs one out. */
+export declare const DEVICES_PATH = "/api/account/devices";
+export declare const DevicesSchema: z.ZodObject<{
+    devices: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        client: z.ZodString;
+        signedInAt: z.ZodISODateTime;
+        lastActiveAt: z.ZodISODateTime;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Devices = z.infer<typeof DevicesSchema>;
+/** The credentials file, relative to the home folder (ALLYHUB_HOME moves it). */
+export declare const CREDENTIALS_FILE = ".allyhub/credentials.json";
+/** A token endpoint's answer (RFC 6749 5.1). */
+export declare const TokenResponseSchema: z.ZodObject<{
+    access_token: z.ZodString;
+    token_type: z.ZodString;
+    expires_in: z.ZodNumber;
+    refresh_token: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type TokenResponse = z.infer<typeof TokenResponseSchema>;
+/** An OAuth error (RFC 6749 5.2, RFC 8628 3.5). */
+export declare const OAuthErrorSchema: z.ZodObject<{
+    error: z.ZodString;
+    error_description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** A device authorization endpoint's answer (RFC 8628 3.2). */
+export declare const DeviceAuthorizationSchema: z.ZodObject<{
+    device_code: z.ZodString;
+    user_code: z.ZodString;
+    verification_uri: z.ZodURL;
+    verification_uri_complete: z.ZodOptional<z.ZodURL>;
+    expires_in: z.ZodNumber;
+    interval: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type DeviceAuthorization = z.infer<typeof DeviceAuthorizationSchema>;
+export declare const AccountSchema: z.ZodObject<{
+    id: z.ZodString;
+    email: z.ZodEmail;
+    name: z.ZodOptional<z.ZodString>;
+    organization: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type Account = z.infer<typeof AccountSchema>;
+/**
+ * The credentials file: the device's sign-in, owner-only (0600). The
+ * refresh token rotates at every use (OAuth 2.1); a token that comes back
+ * refused means signed out.
+ */
+export declare const CredentialsFileSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    url: z.ZodURL;
+    issuer: z.ZodURL;
+    account: z.ZodObject<{
+        id: z.ZodString;
+        email: z.ZodEmail;
+        name: z.ZodOptional<z.ZodString>;
+        organization: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    refreshToken: z.ZodString;
+    access: z.ZodOptional<z.ZodObject<{
+        token: z.ZodString;
+        expiresAt: z.ZodISODateTime;
+    }, z.core.$strict>>;
+    since: z.ZodISODateTime;
+}, z.core.$strict>;
+export type CredentialsFile = z.infer<typeof CredentialsFileSchema>;
+/** What `allyhub auth token --json` prints: an access token for the API, renewed as needed. */
+export declare const TokenOutputSchema: z.ZodObject<{
+    accessToken: z.ZodString;
+    expiresAt: z.ZodISODateTime;
+    account: z.ZodObject<{
+        id: z.ZodString;
+        email: z.ZodEmail;
+        name: z.ZodOptional<z.ZodString>;
+        organization: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type TokenOutput = z.infer<typeof TokenOutputSchema>;
+/** What a client sends with it: `Authorization: Bearer <accessToken>`. */
+export declare const bearer: (token: TokenOutput) => string;
+//# sourceMappingURL=auth.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{z as e}from"zod";export const AuthServerSchema=e.object({issuer:e.url(),authorization_endpoint:e.url(),token_endpoint:e.url(),device_authorization_endpoint:e.url(),revocation_endpoint:e.url(),code_challenge_methods_supported:e.array(e.string()).refine(t=>t.includes("S256"),{message:"The server must take S256 PKCE challenges."})}),CLIENT_ID="allyhub-cli",ISSUER_PATH="/api/auth",METADATA_PATH=`/.well-known/oauth-authorization-server${ISSUER_PATH}`,SCOPES="openid profile email offline_access",ACCOUNT_PATH="/api/account",ORGANIZATION_HEADER="x-allyhub-organization",DEVICES_PAGE_PATH="/devices",DEVICES_PATH="/api/account/devices",DevicesSchema=e.object({devices:e.array(e.object({id:e.string(),client:e.string(),signedInAt:e.iso.datetime(),lastActiveAt:e.iso.datetime()}))}),CREDENTIALS_FILE=".allyhub/credentials.json",TokenResponseSchema=e.object({access_token:e.string().min(1),token_type:e.string(),expires_in:e.number().positive(),refresh_token:e.string().min(1).optional(),scope:e.string().optional()}),OAuthErrorSchema=e.object({error:e.string(),error_description:e.string().optional()}),DeviceAuthorizationSchema=e.object({device_code:e.string().min(1),user_code:e.string().min(1),verification_uri:e.url(),verification_uri_complete:e.url().optional(),expires_in:e.number().positive(),interval:e.number().positive().optional()}),AccountSchema=e.strictObject({id:e.string().min(1),email:e.email(),name:e.string().optional(),organization:e.strictObject({id:e.string().min(1),name:e.string()}).optional()}),CredentialsFileSchema=e.strictObject({version:e.literal(1),url:e.url(),issuer:e.url(),account:AccountSchema,refreshToken:e.string().min(1),access:e.strictObject({token:e.string().min(1),expiresAt:e.iso.datetime({offset:!0})}).optional(),since:e.iso.datetime({offset:!0})}),TokenOutputSchema=e.strictObject({accessToken:e.string().min(1),expiresAt:e.iso.datetime({offset:!0}),account:AccountSchema}),bearer=t=>`Bearer ${t.accessToken}`;