@skillcdn/console 0.0.0-stage → 0.1.1

package/dist/limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../src/limits.ts"],"names":[],"mappings":"AAIA,uDAAuD;AACvD,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,kEAAkE;AAClE,eAAO,MAAM,eAAe,QAAS,CAAC;AACtC,qEAAqE;AACrE,eAAO,MAAM,SAAS,KAAK,CAAC;AAC5B,eAAO,MAAM,qBAAqB,MAAM,CAAC;AACzC,eAAO,MAAM,cAAc,OAAO,CAAC;AACnC,8DAA8D;AAC9D,eAAO,MAAM,WAAW,IAAI,CAAC;AAC7B,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,uCAAuC;AACvC,eAAO,MAAM,eAAe,OAAO,CAAC;AACpC,4FAA4F;AAC5F,eAAO,MAAM,UAAU,MAAM,CAAC;AAC9B,oDAAoD;AACpD,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,0FAA0F;AAC1F,eAAO,MAAM,gBAAgB,KAAK,CAAC;AACnC,uDAAuD;AACvD,eAAO,MAAM,kBAAkB,OAAO,CAAC;AACvC,mEAAmE;AACnE,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,oFAAoF;AACpF,eAAO,MAAM,cAAc,QAAmB,CAAC;AAC/C,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,iFAAiF;AACjF,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,2FAA2F;AAC3F,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,qDAAqD;AACrD,eAAO,MAAM,qBAAqB,KAAK,CAAC"}

package/dist/limits.js

@@ -0,0 +1,40 @@
+// How much of anything the console takes in. Every text a person or an agent writes is bounded
+// at the edge (AGENTS.md, rule 2); these are the bounds, shared by the server that enforces them
+// and the pages that say so before a request is made.
+/** A task's title, a decision's question: one line. */
+export const MAX_TITLE_LENGTH = 200;
+export const MAX_QUESTION_LENGTH = 500;
+/** A body in Markdown: a task's, or the context of a decision. */
+export const MAX_BODY_LENGTH = 20_000;
+/** The links of a task: a repository, a pull request, a document. */
+export const MAX_LINKS = 20;
+export const MAX_LINK_LABEL_LENGTH = 120;
+export const MAX_URL_LENGTH = 2048;
+/** The options of a decision, and how a person words each. */
+export const MIN_OPTIONS = 2;
+export const MAX_OPTIONS = 10;
+export const MAX_OPTION_LABEL_LENGTH = 120;
+/** What a person adds to an answer. */
+export const MAX_NOTE_LENGTH = 2000;
+/** How many tasks or decisions one listing answers with. A board is read whole, for now. */
+export const LIST_LIMIT = 500;
+/** How many events one page of the feed carries. */
+export const EVENTS_PAGE_LIMIT = 100;
+/** What an agent calls itself when it takes a task: its kind, where it runs. One line. */
+export const MAX_AGENT_LENGTH = 80;
+/** What an agent says when it ends a run. Markdown. */
+export const MAX_SUMMARY_LENGTH = 2000;
+/** How many reports, and how many artifacts, one run may carry. */
+export const MAX_REPORTS_PER_RUN = 500;
+export const MAX_ARTIFACTS_PER_RUN = 50;
+/** A file a run hands in: how many bytes, and its name, one line without a path. */
+export const MAX_FILE_BYTES = 10 * 1024 * 1024;
+export const MAX_FILE_NAME_LENGTH = 200;
+/** What a person calls a token: the agent it is for, where it runs. One line. */
+export const MAX_TOKEN_NAME_LENGTH = 80;
+/** How long a token may be good for, in days, and how long one is when nothing is said. */
+export const MAX_TOKEN_DAYS = 365;
+export const DEFAULT_TOKEN_DAYS = 90;
+/** How many tokens one person may hold at a time. */
+export const MAX_TOKENS_PER_PERSON = 25;
+//# sourceMappingURL=limits.js.map

package/dist/limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.js","sourceRoot":"","sources":["../src/limits.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,iGAAiG;AACjG,sDAAsD;AAEtD,uDAAuD;AACvD,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AACpC,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AACvC,kEAAkE;AAClE,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC;AACtC,qEAAqE;AACrE,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,CAAC;AAC5B,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AACzC,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC;AACnC,8DAA8D;AAC9D,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC;AAC7B,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,CAAC;AAC9B,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAC3C,uCAAuC;AACvC,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC;AACpC,4FAA4F;AAC5F,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,CAAC;AAC9B,oDAAoD;AACpD,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AACrC,0FAA0F;AAC1F,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AACnC,uDAAuD;AACvD,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC;AACvC,mEAAmE;AACnE,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AACvC,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AACxC,oFAAoF;AACpF,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAC/C,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AACxC,iFAAiF;AACjF,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AACxC,2FAA2F;AAC3F,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAClC,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AACrC,qDAAqD;AACrD,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC"}

package/dist/router.d.ts

@@ -0,0 +1,37 @@
+import { type SignInFailure } from "./api.js";
+export type Route = {
+    readonly name: "board";
+} | {
+    readonly name: "task";
+    readonly id: string;
+} | {
+    readonly name: "decisions";
+} | {
+    readonly name: "feed";
+} | {
+    readonly name: "skills";
+} | {
+    readonly name: "tokens";
+} | {
+    readonly name: "people";
+} | {
+    readonly name: "not-found";
+};
+export declare const PATHS: {
+    readonly board: "/";
+    readonly tasks: "/tasks";
+    readonly decisions: "/decisions";
+    readonly feed: "/feed";
+    /** The organization's skills, as SkillCDN serves them. */
+    readonly skills: "/skills";
+    /** The tokens of whoever is signed in: their own page. */
+    readonly tokens: "/tokens";
+    readonly people: "/people";
+};
+export declare function matchRoute(pathname: string): Route;
+export declare function taskHref(id: string): string;
+/** Why the last sign-in did not complete, as the page's URL says it, or nothing. */
+export declare function signInFailureOf(search: string): SignInFailure | undefined;
+/** The URL without the sign-in parameter, once the page has read it. */
+export declare function withoutSignInParam(pathname: string, search: string): string;
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAI9E,MAAM,MAAM,KAAK,GACb;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;CAAE,GAC9B;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC;AAEnC,eAAO,MAAM,KAAK;aAChB,KAAK,EAAE,GAAG;aACV,KAAK,EAAE,QAAQ;aACf,SAAS,EAAE,YAAY;aACvB,IAAI,EAAE,OAAO;IACb,0DAA0D;aAC1D,MAAM,EAAE,SAAS;IACjB,0DAA0D;aAC1D,MAAM,EAAE,SAAS;aACjB,MAAM,EAAE,SAAS;CACT,CAAC;AAIX,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CAyBlD;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAGzE;AAED,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAK3E"}

package/dist/router.js

@@ -0,0 +1,55 @@
+import { isSignInFailure, SIGN_IN_PARAM } from "./api.js";
+export const PATHS = {
+    board: "/",
+    tasks: "/tasks",
+    decisions: "/decisions",
+    feed: "/feed",
+    /** The organization's skills, as SkillCDN serves them. */
+    skills: "/skills",
+    /** The tokens of whoever is signed in: their own page. */
+    tokens: "/tokens",
+    people: "/people",
+};
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+export function matchRoute(pathname) {
+    const path = pathname.length > 1 ? pathname.replace(/\/+$/, "") : pathname;
+    if (path === PATHS.board) {
+        return { name: "board" };
+    }
+    if (path === PATHS.decisions) {
+        return { name: "decisions" };
+    }
+    if (path === PATHS.feed) {
+        return { name: "feed" };
+    }
+    if (path === PATHS.skills) {
+        return { name: "skills" };
+    }
+    if (path === PATHS.tokens) {
+        return { name: "tokens" };
+    }
+    if (path === PATHS.people) {
+        return { name: "people" };
+    }
+    if (path.startsWith(`${PATHS.tasks}/`)) {
+        const id = path.slice(PATHS.tasks.length + 1);
+        return UUID.test(id) ? { name: "task", id } : { name: "not-found" };
+    }
+    return { name: "not-found" };
+}
+export function taskHref(id) {
+    return `${PATHS.tasks}/${id}`;
+}
+/** Why the last sign-in did not complete, as the page's URL says it, or nothing. */
+export function signInFailureOf(search) {
+    const value = new URLSearchParams(search).get(SIGN_IN_PARAM);
+    return isSignInFailure(value) ? value : undefined;
+}
+/** The URL without the sign-in parameter, once the page has read it. */
+export function withoutSignInParam(pathname, search) {
+    const params = new URLSearchParams(search);
+    params.delete(SIGN_IN_PARAM);
+    const query = params.toString();
+    return query.length === 0 ? pathname : `${pathname}?${query}`;
+}
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAsB,MAAM,UAAU,CAAC;AAc9E,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,KAAK,EAAE,GAAG;IACV,KAAK,EAAE,QAAQ;IACf,SAAS,EAAE,YAAY;IACvB,IAAI,EAAE,OAAO;IACb,0DAA0D;IAC1D,MAAM,EAAE,SAAS;IACjB,0DAA0D;IAC1D,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,SAAS;CACT,CAAC;AAEX,MAAM,IAAI,GAAG,iEAAiE,CAAC;AAE/E,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC3E,IAAI,IAAI,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC;QACzB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC3B,CAAC;IACD,IAAI,IAAI,KAAK,KAAK,CAAC,SAAS,EAAE,CAAC;QAC7B,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAC/B,CAAC;IACD,IAAI,IAAI,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC;QACxB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC;IACD,IAAI,IAAI,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;QAC1B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC5B,CAAC;IACD,IAAI,IAAI,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;QAC1B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC5B,CAAC;IACD,IAAI,IAAI,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;QAC1B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC5B,CAAC;IACD,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IACtE,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,EAAU;IACjC,OAAO,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;AAChC,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,MAAM,KAAK,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC7D,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACpD,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,MAAc;IACjE,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAChC,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,KAAK,EAAE,CAAC;AAChE,CAAC"}

package/dist/routes.d.ts

@@ -0,0 +1,47 @@
+import type { ProviderKey } from "./vocabulary.js";
+/** One prefix per resource; an id follows where one is needed. */
+export declare const REST_ROUTES: {
+    /** Who is signed in, what the workspace is called, and whether anyone can sign in. */
+    readonly me: "/api/v1/me";
+    /** The people of the workspace: everyone who has signed in. */
+    readonly people: "/api/v1/people";
+    readonly tasks: "/api/v1/tasks";
+    readonly decisions: "/api/v1/decisions";
+    /** The feed, from a point on; and `/stream` under it, the same as it happens. */
+    readonly events: "/api/v1/events";
+    /** The tokens of whoever asks: what their agents, scripts and consoles act as them with. */
+    readonly tokens: "/api/v1/tokens";
+    /** The runs: agents at work, and what they did. */
+    readonly runs: "/api/v1/runs";
+    /** The bytes of a file a run handed in: `/api/v1/files/<artifact id>`. */
+    readonly files: "/api/v1/files";
+    /** The organization's skills, as SkillCDN serves them at the console's address. */
+    readonly skills: "/api/v1/skills";
+};
+/** Where a browser signs in and out. Signing in is per provider: `/auth/<provider>/...`. */
+export declare const AUTH_ROUTES: {
+    /** Sends the browser to the provider to sign in, and afterwards to `return_to`. */
+    readonly login: (provider: ProviderKey) => string;
+    /** Where the provider sends the browser back to. */
+    readonly callback: (provider: ProviderKey) => string;
+    /** A POST from the pages that ends the session. */
+    readonly logout: "/auth/logout";
+};
+/** The parameter of the login route naming the page to come back to: a path of this origin. */
+export declare const RETURN_TO_PARAM = "return_to";
+/**
+ * The parameter by which the server tells a page that a sign-in did not complete: the person
+ * said no at the provider, the attempt was not finished in time or in the browser that began
+ * it, the provider did not confirm it, or the account is not a member of the workspace.
+ */
+export declare const SIGN_IN_PARAM = "sign_in";
+export declare const SIGN_IN_FAILURES: readonly ["denied", "expired", "failed", "refused"];
+export type SignInFailure = (typeof SIGN_IN_FAILURES)[number];
+export declare function isSignInFailure(value: string | null | undefined): value is SignInFailure;
+/** Where a browser leaves for the provider to sign in and come back to `returnTo`. */
+export declare function loginPath(provider: ProviderKey, returnTo: string): string;
+/** A page of this origin, told why the sign-in it was waiting for did not complete. */
+export declare function signInPath(page: string, failure: SignInFailure): string;
+/** The REST path of one task, decision, token, person, run or file: the collection, then the id. */
+export declare function restPath(collection: "tasks" | "decisions" | "tokens" | "people" | "runs" | "files", id: string): string;
+//# sourceMappingURL=routes.d.ts.map

package/dist/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,kEAAkE;AAClE,eAAO,MAAM,WAAW;IACtB,sFAAsF;aACtF,EAAE,EAAE,YAAY;IAChB,+DAA+D;aAC/D,MAAM,EAAE,gBAAgB;aACxB,KAAK,EAAE,eAAe;aACtB,SAAS,EAAE,mBAAmB;IAC9B,iFAAiF;aACjF,MAAM,EAAE,gBAAgB;IACxB,4FAA4F;aAC5F,MAAM,EAAE,gBAAgB;IACxB,mDAAmD;aACnD,IAAI,EAAE,cAAc;IACpB,0EAA0E;aAC1E,KAAK,EAAE,eAAe;IACtB,mFAAmF;aACnF,MAAM,EAAE,gBAAgB;CAChB,CAAC;AAEX,4FAA4F;AAC5F,eAAO,MAAM,WAAW;IACtB,mFAAmF;aACnF,KAAK,aAAa,WAAW,KAAG,MAAM;IACtC,oDAAoD;aACpD,QAAQ,aAAa,WAAW,KAAG,MAAM;IACzC,mDAAmD;aACnD,MAAM,EAAE,cAAc;CACd,CAAC;AAEX,+FAA+F;AAC/F,eAAO,MAAM,eAAe,cAAc,CAAC;AAE3C;;;;GAIG;AACH,eAAO,MAAM,aAAa,YAAY,CAAC;AACvC,eAAO,MAAM,gBAAgB,YAAI,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC;AACpF,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,IAAI,aAAa,CAExF;AAED,sFAAsF;AACtF,wBAAgB,SAAS,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,uFAAuF;AACvF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAEvE;AAED,oGAAoG;AACpG,wBAAgB,QAAQ,CACtB,UAAU,EAAE,OAAO,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,EAC1E,EAAE,EAAE,MAAM,GACT,MAAM,CAER"}

package/dist/routes.js

@@ -0,0 +1,53 @@
+/** One prefix per resource; an id follows where one is needed. */
+export const REST_ROUTES = {
+    /** Who is signed in, what the workspace is called, and whether anyone can sign in. */
+    me: "/api/v1/me",
+    /** The people of the workspace: everyone who has signed in. */
+    people: "/api/v1/people",
+    tasks: "/api/v1/tasks",
+    decisions: "/api/v1/decisions",
+    /** The feed, from a point on; and `/stream` under it, the same as it happens. */
+    events: "/api/v1/events",
+    /** The tokens of whoever asks: what their agents, scripts and consoles act as them with. */
+    tokens: "/api/v1/tokens",
+    /** The runs: agents at work, and what they did. */
+    runs: "/api/v1/runs",
+    /** The bytes of a file a run handed in: `/api/v1/files/<artifact id>`. */
+    files: "/api/v1/files",
+    /** The organization's skills, as SkillCDN serves them at the console's address. */
+    skills: "/api/v1/skills",
+};
+/** Where a browser signs in and out. Signing in is per provider: `/auth/<provider>/...`. */
+export const AUTH_ROUTES = {
+    /** Sends the browser to the provider to sign in, and afterwards to `return_to`. */
+    login: (provider) => `/auth/${provider}/login`,
+    /** Where the provider sends the browser back to. */
+    callback: (provider) => `/auth/${provider}/callback`,
+    /** A POST from the pages that ends the session. */
+    logout: "/auth/logout",
+};
+/** The parameter of the login route naming the page to come back to: a path of this origin. */
+export const RETURN_TO_PARAM = "return_to";
+/**
+ * The parameter by which the server tells a page that a sign-in did not complete: the person
+ * said no at the provider, the attempt was not finished in time or in the browser that began
+ * it, the provider did not confirm it, or the account is not a member of the workspace.
+ */
+export const SIGN_IN_PARAM = "sign_in";
+export const SIGN_IN_FAILURES = ["denied", "expired", "failed", "refused"];
+export function isSignInFailure(value) {
+    return SIGN_IN_FAILURES.includes(value ?? "");
+}
+/** Where a browser leaves for the provider to sign in and come back to `returnTo`. */
+export function loginPath(provider, returnTo) {
+    return `${AUTH_ROUTES.login(provider)}?${RETURN_TO_PARAM}=${encodeURIComponent(returnTo)}`;
+}
+/** A page of this origin, told why the sign-in it was waiting for did not complete. */
+export function signInPath(page, failure) {
+    return `${page}${page.includes("?") ? "&" : "?"}${SIGN_IN_PARAM}=${failure}`;
+}
+/** The REST path of one task, decision, token, person, run or file: the collection, then the id. */
+export function restPath(collection, id) {
+    return `${REST_ROUTES[collection]}/${encodeURIComponent(id)}`;
+}
+//# sourceMappingURL=routes.js.map

package/dist/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAIA,kEAAkE;AAClE,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,sFAAsF;IACtF,EAAE,EAAE,YAAY;IAChB,+DAA+D;IAC/D,MAAM,EAAE,gBAAgB;IACxB,KAAK,EAAE,eAAe;IACtB,SAAS,EAAE,mBAAmB;IAC9B,iFAAiF;IACjF,MAAM,EAAE,gBAAgB;IACxB,4FAA4F;IAC5F,MAAM,EAAE,gBAAgB;IACxB,mDAAmD;IACnD,IAAI,EAAE,cAAc;IACpB,0EAA0E;IAC1E,KAAK,EAAE,eAAe;IACtB,mFAAmF;IACnF,MAAM,EAAE,gBAAgB;CAChB,CAAC;AAEX,4FAA4F;AAC5F,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,mFAAmF;IACnF,KAAK,EAAE,CAAC,QAAqB,EAAU,EAAE,CAAC,SAAS,QAAQ,QAAQ;IACnE,oDAAoD;IACpD,QAAQ,EAAE,CAAC,QAAqB,EAAU,EAAE,CAAC,SAAS,QAAQ,WAAW;IACzE,mDAAmD;IACnD,MAAM,EAAE,cAAc;CACd,CAAC;AAEX,+FAA+F;AAC/F,MAAM,CAAC,MAAM,eAAe,GAAG,WAAW,CAAC;AAE3C;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,SAAS,CAAC;AACvC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC;AAGpF,MAAM,UAAU,eAAe,CAAC,KAAgC;IAC9D,OAAQ,gBAAsC,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;AACvE,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,SAAS,CAAC,QAAqB,EAAE,QAAgB;IAC/D,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,eAAe,IAAI,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC;AAC7F,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,OAAsB;IAC7D,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,aAAa,IAAI,OAAO,EAAE,CAAC;AAC/E,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,QAAQ,CACtB,UAA0E,EAC1E,EAAU;IAEV,OAAO,GAAG,WAAW,CAAC,UAAU,CAAC,IAAI,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC;AAChE,CAAC"}