pinecall 0.1.0

package/dist/cli/numbers.js

@@ -0,0 +1,132 @@
+/** `pinecall numbers list | import | move | drop`: which number reaches which agent, in which world. */
+import { parseArgs } from "node:util";
+import { theDoor } from "./env.js";
+import { asked } from "./testing/gateway.js";
+import { refusal } from "./whoami.js";
+const USAGE = `usage: pinecall numbers list
+       pinecall numbers import <+34…> --agent <slug> [--channel phone|whatsapp] [--dry-run]
+       pinecall numbers move <+34…> --env <production|sandbox>
+       pinecall numbers drop <+34…>`;
+const NUMBERS = "/v1/numbers";
+// A door the org answers at, and which table put it there: an operator typed it, or the class
+// declared it in its `routes`. Only the first is a row, and only a row can be moved or dropped.
+const AN_OPERATORS = "operator";
+export const group = {
+    purpose: "list | import | move | drop the numbers the org answers at",
+    usage: `${USAGE}
+
+  A number exists once in a world and reaches one agent. \`list\` shows the key's world only,
+  because that is the world this key works in; \`move\` is the one verb that crosses, and it is
+  what makes a staging run cost nothing — point the org's real number at the sandbox for an
+  afternoon, try the new agent on it, and move it back. The carrier is untouched either way: a
+  call arrives at this box whichever world answers it.
+
+  \`import\` takes a number the org's carrier account already owns and points it here: the
+  carrier's trunk, the SFU's trunk, the route — \`--dry-run\` prints those steps and writes
+  nothing. \`drop\` forgets the route and takes the number off the SFU trunk; the carrier account
+  keeps it, so nobody is un-bought by a typo.`,
+    run,
+};
+export async function run(argv, how = {}) {
+    const out = how.out ?? process.stdout;
+    const err = how.err ?? process.stderr;
+    const verb = argv[0] ?? "list";
+    const door = theDoor(how.env ?? process.env, err);
+    if (door === undefined)
+        return 1;
+    try {
+        if (verb === "list")
+            return await list(door, out);
+        if (verb === "import")
+            return await brought(argv.slice(1), door, out, err);
+        if (verb === "move")
+            return await moved(argv.slice(1), door, out, err);
+        if (verb === "drop")
+            return await dropped(argv[1], door, out, err);
+    }
+    catch (refused) {
+        err.write(`${refusal(refused)}\n`);
+        return 1;
+    }
+    err.write(`${USAGE}\n`);
+    return 2;
+}
+/** Every door the org answers at in this key's world, one line each. */
+async function list(door, out) {
+    const doors = await asked(door, NUMBERS);
+    if (doors.length === 0) {
+        out.write("no number answers in this world: `pinecall numbers import <+34…> --agent <slug>`\n");
+        return 0;
+    }
+    for (const one of doors)
+        out.write(`${aLine(one)}\n`);
+    return 0;
+}
+/** One door as a person reads it: the number, whose it is, where, and who put it there. */
+export function aLine(one) {
+    const said = [one.route.number ?? "—", one.route.channel, `→ ${one.route.agent}`, one.route.env];
+    if (one.source !== AN_OPERATORS)
+        said.push(`declared by the app`);
+    else if (one.route.managed)
+        said.push("bought here");
+    return said.join(" · ");
+}
+/** A number the carrier already owns, pointed at this box and at one agent. */
+async function brought(argv, door, out, err) {
+    const { values, positionals } = parseArgs({
+        args: argv,
+        allowPositionals: true,
+        options: { agent: { type: "string" }, channel: { type: "string" }, "dry-run": { type: "boolean", default: false } },
+    });
+    const number = positionals[0];
+    if (number === undefined || values.agent === undefined) {
+        err.write(`${USAGE}\n  a number and the --agent that answers it\n`);
+        return 2;
+    }
+    const body = { number, agent: values.agent };
+    if (values.channel !== undefined)
+        body["channel"] = values.channel;
+    const path = values["dry-run"] === true ? `${NUMBERS}?dry_run=true` : NUMBERS;
+    const done = await asked(door, path, { method: "POST", body });
+    for (const step of done.steps)
+        out.write(`  ${step}\n`);
+    if (done.dry_run)
+        out.write("  nothing written: drop --dry-run to do it\n");
+    return 0;
+}
+/**
+ * The one verb that crosses the two worlds.
+ *
+ * An org buys ONE number, so a team that wants to try a new agent on the real line has nowhere to
+ * try it: a second number is a second bill, and a third world would be a third of everything. The
+ * row says which world answers, and this moves the row. Moving it back is the same verb.
+ */
+async function moved(argv, door, out, err) {
+    const { values, positionals } = parseArgs({ args: argv, allowPositionals: true, options: { env: { type: "string" } } });
+    const number = positionals[0];
+    if (number === undefined || values.env === undefined) {
+        err.write(`${USAGE}\n  a number and the --env it should answer in\n`);
+        return 2;
+    }
+    const answer = await asked(door, `${NUMBERS}/${encodeURIComponent(number)}/env`, {
+        method: "PUT",
+        body: { env: values.env },
+    });
+    if (!answer.moved) {
+        out.write(`${answer.said ?? `${number} is already in ${answer.route.env}`}\n`);
+        return 0;
+    }
+    out.write(`${number} · ${answer.from} → ${answer.route.env} · → ${answer.route.agent}\n`);
+    return 0;
+}
+/** The route gone and the number off this org's SFU trunk. The carrier account keeps the number. */
+async function dropped(number, door, out, err) {
+    if (number === undefined) {
+        err.write(`${USAGE}\n  which number to forget\n`);
+        return 2;
+    }
+    await asked(door, `${NUMBERS}/${encodeURIComponent(number)}`, { method: "DELETE" });
+    out.write(`${number} answers nothing here now. Your carrier still owns it.\n`);
+    return 0;
+}
+//# sourceMappingURL=numbers.js.map

package/dist/cli/numbers.js.map

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

package/dist/cli/personas.d.ts

@@ -0,0 +1,5 @@
+/** `pinecall personas list | show <n> | try <n>`: the synthetic callers this app is tested with. */
+import type { Group } from "./groups.js";
+export declare const group: Group;
+export declare function run(argv: string[], out?: NodeJS.WritableStream): Promise<number>;
+//# sourceMappingURL=personas.d.ts.map

package/dist/cli/personas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"personas.d.ts","sourceRoot":"","sources":["../../src/cli/personas.ts"],"names":[],"mappings":"AAAA,oGAAoG;AAIpG,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAMzC,eAAO,MAAM,KAAK,EAAE,KAanB,CAAC;AAMF,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,GAAE,MAAM,CAAC,cAA+B,GAAG,OAAO,CAAC,MAAM,CAAC,CActG"}

package/dist/cli/personas.js

@@ -0,0 +1,94 @@
+/** `pinecall personas list | show <n> | try <n>`: the synthetic callers this app is tested with. */
+import { parseArgs } from "node:util";
+import { aSimulation, TURNS } from "./simulate.js";
+import { NO_PERSONAS, personaNamed, personasIn } from "./testing/caller.js";
+const USAGE = "usage: pinecall personas list | show <name> | try <name> [--file agent.tsx]\n";
+export const group = {
+    purpose: "list | show | try the synthetic callers in test/personas",
+    usage: `${USAGE}
+  A persona is a caller a model plays: a goal, a style, the facts they may state about
+  themselves, and the state the call opens in. One file per caller under test/personas,
+  default-exporting one.
+
+  list            every caller of this directory, with the goal each one pursues
+  show <name>     that caller whole, facts and all
+  try <name>      one improvised line from them, through the gateway's caller door — the same
+                  door \`pinecall simulate\` asks for every turn. Needs a key
+  --file <path>   which class to read the personas beside, when there is more than one`,
+    run,
+};
+// A caller with no facts of their own is not broken — they are somebody who will invent nothing,
+// which is what the model playing them is told. `show` says so rather than printing an empty block.
+const NO_FACTS = "(no facts: this caller may state nothing about themselves)";
+export async function run(argv, out = process.stdout) {
+    const { values, positionals } = parseArgs({
+        args: argv,
+        allowPositionals: true,
+        options: { file: { type: "string" }, json: { type: "boolean", default: false } },
+    });
+    const [verb, name] = positionals;
+    if (verb === "list")
+        return await listed(values.json === true, out);
+    if (verb === "show" && name !== undefined)
+        return await shown(name, values.json === true, out);
+    // `try` runs the caller against the class, because reading a persona tells you who they are and
+    // only a call tells you how they land. It is `simulate` without the judge — one implementation.
+    if (verb === "try" && name !== undefined)
+        return await tried(name, values.file, out);
+    process.stderr.write(USAGE);
+    return 2;
+}
+/** One line per caller: the name a verb takes, and the goal it is written to pursue. */
+async function listed(asJson, out) {
+    const personas = await personasIn();
+    if (personas.length === 0) {
+        process.stderr.write(`${NO_PERSONAS}\n`);
+        return 2;
+    }
+    if (asJson)
+        out.write(`${JSON.stringify({ personas })}\n`);
+    else
+        out.write(`${personas.map(oneLine).join("\n")}\n`);
+    return 0;
+}
+/** One caller whole: how they talk, and every fact about themselves they are allowed to state. */
+async function shown(name, asJson, out) {
+    const persona = await personaNamed(name);
+    if (persona === undefined) {
+        process.stderr.write(`no persona called ${name}: ${NO_PERSONAS}\n`);
+        return 2;
+    }
+    if (asJson)
+        out.write(`${JSON.stringify(persona)}\n`);
+    else
+        out.write(`${linesOf(persona).join("\n")}\n`);
+    return 0;
+}
+/** The lines `show` prints: the caller, the goal, the style, and every fact they may state. */
+function linesOf(persona) {
+    const facts = Object.entries(persona.facts ?? {});
+    return [
+        `${persona.name} · ${persona.goal}`,
+        `  ${persona.style}`,
+        ...(facts.length === 0 ? [`  ${NO_FACTS}`] : facts.map(([name, value]) => `  ${name}: ${String(value)}`)),
+    ];
+}
+async function tried(name, agentFile, out) {
+    const persona = await personaNamed(name);
+    if (persona === undefined) {
+        process.stderr.write(`no persona called ${name}: ${NO_PERSONAS}\n`);
+        return 2;
+    }
+    const said = await aSimulation(persona, {
+        agentFile,
+        judge: false,
+        voice: false,
+        turns: TURNS,
+        out,
+    });
+    return said === undefined ? 2 : 0;
+}
+function oneLine(persona) {
+    return `${persona.name.padEnd(12)}  ${persona.style.padEnd(46)}  ${persona.goal}`;
+}
+//# sourceMappingURL=personas.js.map

package/dist/cli/personas.js.map

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

package/dist/cli/pipeline.d.ts

@@ -0,0 +1,52 @@
+/** `pinecall pipeline`: what an agent hears, decides and speaks with, and the knobs an operator turns. */
+import type { Group } from "./groups.js";
+export declare const group: Group;
+/** One leg of the three: which vendor runs it, which model, and the one knob worth showing. */
+interface Stage {
+    vendor: string;
+    model: string | null;
+    voice_id: string | null;
+    language: string | null;
+}
+/** The six knobs. A knob left out of a PUT is not overridden at all. */
+interface Overridden {
+    voice: string | null;
+    tts: string | null;
+    tts_model: string | null;
+    stt: string | null;
+    llm: string | null;
+    greeting: string | null;
+}
+/** One latency over the agent's recent calls, under livekit's own name for it. */
+interface Measured {
+    name: string;
+    seconds: number;
+    turns: number;
+}
+/** What the pipeline door answers: the legs, the opening, what is turned, and what it cost. */
+interface Report {
+    agent: string;
+    hears: Stage;
+    decides: Stage;
+    speaks: Stage;
+    greeting: {
+        say: string | null;
+        reply: string | null;
+    } | null;
+    overrides: Overridden;
+    voices: string[];
+    calls: number;
+    medians: Measured[];
+    unavailable_reasons: Record<string, string>;
+}
+/** What the verb can be told besides the argv: where to print, and which environment. Tests only. */
+export interface Turning {
+    out?: NodeJS.WritableStream;
+    err?: NodeJS.WritableStream;
+    env?: NodeJS.ProcessEnv;
+}
+export declare function run(argv: string[], how?: Turning): Promise<number>;
+/** The whole screen as a page of text: the three legs, the opening, the medians, what is turned. */
+export declare function linesOf(report: Report): string[];
+export {};
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/cli/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/cli/pipeline.ts"],"names":[],"mappings":"AAAA,0GAA0G;AAK1G,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAWzC,eAAO,MAAM,KAAK,EAAE,KAoBnB,CAAC;AAEF,+FAA+F;AAC/F,UAAU,KAAK;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,wEAAwE;AACxE,UAAU,UAAU;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,kFAAkF;AAClF,UAAU,QAAQ;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,+FAA+F;AAC/F,UAAU,MAAM;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,KAAK,CAAC;IACd,QAAQ,EAAE;QAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9D,SAAS,EAAE,UAAU,CAAC;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C;AAYD,qGAAqG;AACrG,MAAM,WAAW,OAAO;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,GAAE,OAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CA0C5E;AA2DD,oGAAoG;AACpG,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAiBhD"}

package/dist/cli/pipeline.js

@@ -0,0 +1,184 @@
+/** `pinecall pipeline`: what an agent hears, decides and speaks with, and the knobs an operator turns. */
+import { parseArgs } from "node:util";
+import { theDoor } from "./env.js";
+import { agentOfThisDirectory, notASlug } from "./load.js";
+import { asked } from "./testing/gateway.js";
+import { refusal } from "./whoami.js";
+const USAGE = [
+    "usage: pinecall pipeline [--agent <slug>] [--json]",
+    "       pinecall pipeline set [--stt x] [--llm x] [--tts x] [--voice x] [--tts-model x] [--greeting '…']",
+    "       pinecall pipeline clear [stt|llm|tts|voice|tts-model|greeting …]",
+].join("\n");
+export const group = {
+    purpose: "what the agent hears, decides and speaks with, and the six knobs an operator turns",
+    usage: `${USAGE}
+
+  With nothing after it: the three legs of the pipeline as the NEXT call would be built — the
+  vendor, the model and the one knob worth showing — what the class declared as its opening, the
+  medians livekit measured over the agent's recent calls, and which of the six knobs is turned.
+
+  set turns a knob for every call from the next one, held by the gateway and not by a deploy. A
+  model knob reads three ways: \`--llm anthropic/claude-haiku-4-5\` names both, \`--llm cartesia\`
+  names a VENDOR and keeps that vendor's own default model, and \`--llm claude-haiku-4-5\` keeps
+  whichever vendor is in use. \`--tts\` is the vendor that speaks, and the voice beside it is then
+  that vendor's own id. A knob nobody names here is left exactly as it stands.
+
+  clear gives a knob back to what the app declared. With no name it gives back all six. There is
+  no blank value: an empty voice once silenced a whole line of calls, and the door refuses one.
+
+  \`pinecall providers\` lists every vendor a knob may name and what each one still wants; the same
+  six knobs are the console's Pipeline screen, over the same two doors.`,
+    run,
+};
+/** The knob as it is typed, and the knob as the wire carries it. One table, both directions. */
+const KNOBS = {
+    stt: "stt",
+    llm: "llm",
+    tts: "tts",
+    voice: "voice",
+    "tts-model": "tts_model",
+    greeting: "greeting",
+};
+export async function run(argv, how = {}) {
+    const out = how.out ?? process.stdout;
+    const err = how.err ?? process.stderr;
+    const { values, positionals } = parseArgs({
+        args: argv,
+        allowPositionals: true,
+        options: {
+            agent: { type: "string" },
+            json: { type: "boolean", default: false },
+            stt: { type: "string" },
+            llm: { type: "string" },
+            tts: { type: "string" },
+            voice: { type: "string" },
+            "tts-model": { type: "string" },
+            greeting: { type: "string" },
+        },
+    });
+    const door = theDoor(how.env ?? process.env, err);
+    if (door === undefined)
+        return 2;
+    const aFile = notASlug(values.agent);
+    if (aFile !== undefined) {
+        err.write(`${aFile}\n`);
+        return 2;
+    }
+    const agent = values.agent ?? (await agentOfThisDirectory());
+    if (agent === null || agent === undefined) {
+        err.write(`${USAGE}\n  name the agent, or run this beside an agent file\n`);
+        return 2;
+    }
+    const [verb, ...named] = positionals;
+    try {
+        if (verb === undefined)
+            return said(await read(door, agent), values.json === true, out);
+        if (verb === "set")
+            return said(await turned(door, agent, asKnobs(values)), values.json === true, out);
+        if (verb === "clear")
+            return said(await cleared(door, agent, named), values.json === true, out);
+    }
+    catch (refused) {
+        // The gateway's own sentence: it is the one that knows this build's vendors and this build's
+        // voices, and a knob refused here says which of the six it was and what it may be.
+        err.write(`${refusal(refused)}\n`);
+        return 1;
+    }
+    err.write(`${USAGE}\n`);
+    return 2;
+}
+// ── the two doors ───────────────────────────────────────────────────────────────
+async function read(door, agent) {
+    return await asked(door, `${pathFor(agent)}`);
+}
+// The door takes the WHOLE set, so a knob nobody named on this command line is read back and sent
+// again: `set --llm x` twice in a row must not quietly give the voice back to the class.
+async function turned(door, agent, wanted) {
+    const standing = (await read(door, agent)).overrides;
+    return await asked(door, `${pathFor(agent)}/overrides`, {
+        method: "PUT",
+        body: { ...held(standing), ...wanted },
+    });
+}
+async function cleared(door, agent, named) {
+    const unknown = named.filter((name) => KNOBS[name] === undefined);
+    if (unknown.length > 0)
+        throw new Error(`no knob called ${unknown.join(", ")}: ${Object.keys(KNOBS).join(" · ")}`);
+    // No name at all is every knob at once: the whole set left out is how the door says "as declared".
+    if (named.length === 0)
+        return await asked(door, `${pathFor(agent)}/overrides`, { method: "PUT", body: {} });
+    const keeping = held((await read(door, agent)).overrides);
+    for (const name of named)
+        delete keeping[KNOBS[name]];
+    return await asked(door, `${pathFor(agent)}/overrides`, { method: "PUT", body: keeping });
+}
+/** What is turned right now, as a body the door takes: a knob nobody turned is not a field at all. */
+function held(standing) {
+    const body = {};
+    for (const knob of Object.values(KNOBS)) {
+        const value = standing[knob];
+        if (typeof value === "string" && value !== "")
+            body[knob] = value;
+    }
+    return body;
+}
+/** The knobs this command line named, under the names the wire uses. */
+function asKnobs(values) {
+    const wanted = {};
+    for (const [typed, knob] of Object.entries(KNOBS)) {
+        const value = values[typed];
+        if (typeof value === "string")
+            wanted[knob] = value;
+    }
+    return wanted;
+}
+function pathFor(agent) {
+    return `/v1/agents/${encodeURIComponent(agent)}/pipeline`;
+}
+// ── what a person reads ─────────────────────────────────────────────────────────
+function said(report, asJson, out) {
+    out.write(asJson ? `${JSON.stringify(report)}\n` : `${linesOf(report).join("\n")}\n`);
+    return 0;
+}
+/** The whole screen as a page of text: the three legs, the opening, the medians, what is turned. */
+export function linesOf(report) {
+    const calls = `${report.calls} call${report.calls === 1 ? "" : "s"}`;
+    const lines = [`${report.agent} · ${calls}`, ""];
+    lines.push(`  hears     ${stageLine(report.hears)}${turnedAt(report, "stt")}`);
+    lines.push(`  decides   ${stageLine(report.decides)}${turnedAt(report, "llm")}`);
+    lines.push(`  speaks    ${stageLine(report.speaks)}${turnedAt(report, "tts", "voice", "tts_model")}`);
+    const opening = openingLine(report);
+    if (opening !== "")
+        lines.push("", `  greeting  ${opening}${turnedAt(report, "greeting")}`);
+    if (report.medians.length > 0) {
+        lines.push("", `  ${report.medians.map((one) => `${one.name} ${one.seconds.toFixed(2)}s`).join(" · ")}`);
+    }
+    const off = Object.entries(report.unavailable_reasons);
+    if (off.length > 0) {
+        lines.push("");
+        for (const [vendor, why] of off)
+            lines.push(`  ${vendor} is not available here: ${why}`);
+    }
+    return lines;
+}
+/** One leg on one line: the vendor, then whichever of the model, the voice and the language it has. */
+function stageLine(stage) {
+    const said = [stage.vendor, stage.model, stage.voice_id, stage.language];
+    return said.filter((word) => typeof word === "string" && word !== "").join(" · ");
+}
+/** The opening the next call is built with: the words, or that the class improvises them. */
+function openingLine(report) {
+    const greeting = report.greeting;
+    if (greeting === null)
+        return "";
+    if (greeting.say !== null && greeting.say !== "")
+        return `"${greeting.say}"`;
+    return `the class improvises: ${greeting.reply ?? ""}`;
+}
+// A turned knob is marked where it shows, and never silently: an operator reading this page has to
+// be able to tell what the app declared from what somebody turned last night.
+function turnedAt(report, ...knobs) {
+    const turned = knobs.filter((knob) => typeof report.overrides[knob] === "string" && report.overrides[knob] !== "");
+    return turned.length === 0 ? "" : `   ← turned: ${turned.join(", ")}`;
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/cli/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/cli/pipeline.ts"],"names":[],"mappings":"AAAA,0GAA0G;AAE1G,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAa,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,MAAM,KAAK,GAAG;IACZ,oDAAoD;IACpD,yGAAyG;IACzG,yEAAyE;CAC1E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,CAAC,MAAM,KAAK,GAAU;IAC1B,OAAO,EAAE,oFAAoF;IAC7F,KAAK,EAAE,GAAG,KAAK;;;;;;;;;;;;;;;;wEAgBuD;IACtE,GAAG;CACJ,CAAC;AAyCF,gGAAgG;AAChG,MAAM,KAAK,GAAqC;IAC9C,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,KAAK,EAAE,OAAO;IACd,WAAW,EAAE,WAAW;IACxB,QAAQ,EAAE,UAAU;CACrB,CAAC;AASF,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAc,EAAE,GAAG,GAAY,EAAE;IACzD,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;IACtC,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;IACtC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC;QACxC,IAAI,EAAE,IAAI;QACV,gBAAgB,EAAE,IAAI;QACtB,OAAO,EAAE;YACP,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;YACzC,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACvB,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACvB,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACvB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC/B,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC7B;KACF,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAClD,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC;QACxB,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,oBAAoB,EAAE,CAAC,CAAC;IAC7D,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,wDAAwD,CAAC,CAAC;QAC5E,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,GAAG,WAAW,CAAC;IACrC,IAAI,CAAC;QACH,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,GAAG,CAAC,CAAC;QACxF,IAAI,IAAI,KAAK,KAAK;YAAE,OAAO,IAAI,CAAC,MAAM,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,GAAG,CAAC,CAAC;QACvG,IAAI,IAAI,KAAK,OAAO;YAAE,OAAO,IAAI,CAAC,MAAM,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,GAAG,CAAC,CAAC;IAClG,CAAC;IAAC,OAAO,OAAO,EAAE,CAAC;QACjB,6FAA6F;QAC7F,mFAAmF;QACnF,GAAG,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,CAAC,CAAC;IACX,CAAC;IACD,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC;IACxB,OAAO,CAAC,CAAC;AACX,CAAC;AAED,mFAAmF;AAEnF,KAAK,UAAU,IAAI,CAAC,IAAU,EAAE,KAAa;IAC3C,OAAO,MAAM,KAAK,CAAS,IAAI,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,kGAAkG;AAClG,yFAAyF;AACzF,KAAK,UAAU,MAAM,CAAC,IAAU,EAAE,KAAa,EAAE,MAA2B;IAC1E,MAAM,QAAQ,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACrD,OAAO,MAAM,KAAK,CAAS,IAAI,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE;QAC9D,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,GAAG,MAAM,EAAE;KACvC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,IAAU,EAAE,KAAa,EAAE,KAAe;IAC/D,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC;IAClE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACnH,mGAAmG;IACnG,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,KAAK,CAAS,IAAI,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACrH,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC1D,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAE,CAAC,CAAC;IACvD,OAAO,MAAM,KAAK,CAAS,IAAI,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AACpG,CAAC;AAED,sGAAsG;AACtG,SAAS,IAAI,CAAC,QAAoB;IAChC,MAAM,IAAI,GAA8C,EAAE,CAAC;IAC3D,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,EAAE;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACpE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,wEAAwE;AACxE,SAAS,OAAO,CAAC,MAA+B;IAC9C,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACtD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,OAAO,CAAC,KAAa;IAC5B,OAAO,cAAc,kBAAkB,CAAC,KAAK,CAAC,WAAW,CAAC;AAC5D,CAAC;AAED,mFAAmF;AAEnF,SAAS,IAAI,CAAC,MAAc,EAAE,MAAe,EAAE,GAA0B;IACvE,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtF,OAAO,CAAC,CAAC;AACX,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,OAAO,CAAC,MAAc;IACpC,MAAM,KAAK,GAAG,GAAG,MAAM,CAAC,KAAK,QAAQ,MAAM,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;IACrE,MAAM,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,MAAM,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IACjD,KAAK,CAAC,IAAI,CAAC,eAAe,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;IAC/E,KAAK,CAAC,IAAI,CAAC,eAAe,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;IACjF,KAAK,CAAC,IAAI,CAAC,eAAe,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC;IACtG,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,OAAO,KAAK,EAAE;QAAE,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,eAAe,OAAO,GAAG,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC;IAC5F,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC3G,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IACvD,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,GAAG;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,2BAA2B,GAAG,EAAE,CAAC,CAAC;IAC3F,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,uGAAuG;AACvG,SAAS,SAAS,CAAC,KAAY;IAC7B,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACzE,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACpG,CAAC;AAED,6FAA6F;AAC7F,SAAS,WAAW,CAAC,MAAc;IACjC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IACjC,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IACjC,IAAI,QAAQ,CAAC,GAAG,KAAK,IAAI,IAAI,QAAQ,CAAC,GAAG,KAAK,EAAE;QAAE,OAAO,IAAI,QAAQ,CAAC,GAAG,GAAG,CAAC;IAC7E,OAAO,yBAAyB,QAAQ,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;AACzD,CAAC;AAED,mGAAmG;AACnG,8EAA8E;AAC9E,SAAS,QAAQ,CAAC,MAAc,EAAE,GAAG,KAA2B;IAC9D,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACnH,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACxE,CAAC"}

package/dist/cli/profiles.d.ts

@@ -0,0 +1,70 @@
+/** ~/.pinecall/config.json: the gateways this machine knows, by name, and which one is in hand. */
+/** One gateway this machine can reach: where it is, what opens it, and whose org that key names. */
+export interface Profile {
+    url: string;
+    key: string;
+    /** The org the key belongs to, as `whoami` last said it. A label, never a check. */
+    org?: string;
+    /** The world it opens, likewise: printed, never trusted over what the gateway says. */
+    env?: string;
+    /** The phone this person calls FROM, so a ring in the sandbox reaches their own agent. */
+    calling?: string;
+}
+/** The file: every profile by name, and the one a verb uses when nobody names another. */
+export interface Config {
+    active?: string;
+    profiles: Record<string, Profile>;
+}
+/**
+ * Every profile this machine has, and which is active.
+ *
+ * There were four files and three variables answering two questions — which gateway, and which
+ * key — with a precedence nobody was ever told. This is the one file. The one it replaces is
+ * read ONCE, here, and written into it: `~/.pinecall/credentials`, which `pinecall login` kept a
+ * row per gateway in. It is not deleted — v1's CLI still reads it on this same machine — and it is
+ * not read again once this file exists. The third source, `~/.pinecall/dev`, went with the dev key
+ * that wrote it: a local gateway runs the same Postgres and the same issued keys a box does.
+ */
+export declare function readConfig(home?: string): Config;
+/**
+ * Take `--profile <name>` out of an invocation's argv, and remember it.
+ *
+ * Returns what is left, so the group sees only its own flags. `--profile=<name>` too, because
+ * both spellings are what a person types and only one of them working is a footgun.
+ */
+export declare function withoutTheProfileFlag(argv: readonly string[]): string[];
+/** The profile this invocation named, when it named one. */
+export declare function theChosenProfile(): string | undefined;
+/** The profile a verb runs on: the one named, or the active one, or nothing at all. */
+export declare function profileFor(named: string | undefined, home?: string): Profile | undefined;
+/** Which profile is in hand, for a line that says where a verb is about to go. */
+export declare function activeName(home?: string): string | undefined;
+/** Keep one profile and make it the active one: what `pinecall login` does when it has a key. */
+export declare function writeProfile(name: string, profile: Profile, home?: string): void;
+/** Make a profile that is already there the active one. False when there is no such name. */
+export declare function activate(name: string, home?: string): boolean;
+/**
+ * Forget a gateway. False when there is no such name, so a typo is never silence.
+ *
+ * A profile is a key in a file, and a key that opens nothing is worse than none: somebody will
+ * trust it tomorrow and read the refusal as the gateway's fault. This is the only way to take one
+ * out, and it takes the active mark with it rather than leaving it pointing at a row that is gone.
+ */
+export declare function forget(name: string, home?: string): boolean;
+/** The phone this person calls FROM at the gateway in hand, so a ring reaches their own agent. */
+export declare function callingFrom(home?: string): string | undefined;
+/** Say which phone is yours here, or take it back. False when there is no profile to write it on. */
+export declare function callsFrom(number: string | undefined, home?: string): boolean;
+/** Change one field of a profile without touching its key: what `line from` writes. */
+export declare function amend(name: string, fields: Partial<Profile>, home?: string, whole?: boolean): boolean;
+/**
+ * What to call a profile for this gateway: the host's first label, and `local` for a loopback.
+ *
+ * A name is for a person to type — `pinecall use box` — so it is short and it is theirs to
+ * override with `--as`. A second gateway that would take a name already spoken for gets a number,
+ * because silently repointing a name is how somebody deploys to the wrong box.
+ */
+export declare function nameFor(url: string, config: Config): string;
+/** Whichever profile points at this gateway, by name, when one does. */
+export declare function nameOfGateway(url: string, config: Config): string | undefined;
+//# sourceMappingURL=profiles.d.ts.map

package/dist/cli/profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../src/cli/profiles.ts"],"names":[],"mappings":"AAAA,mGAAmG;AAanG,oGAAoG;AACpG,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,oFAAoF;IACpF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,uFAAuF;IACvF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0FAA0F;IAC1F,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,0FAA0F;AAC1F,MAAM,WAAW,MAAM;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,IAAI,GAAE,MAAuB,GAAG,MAAM,CAEhE;AA+BD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAcvE;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAErD;AAED,uFAAuF;AACvF,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,GAAE,MAAuB,GAAG,OAAO,GAAG,SAAS,CAIxG;AAED,kFAAkF;AAClF,wBAAgB,UAAU,CAAC,IAAI,GAAE,MAAuB,GAAG,MAAM,GAAG,SAAS,CAE5E;AAED,iGAAiG;AACjG,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,GAAE,MAAuB,GAAG,IAAI,CAKhG;AAED,6FAA6F;AAC7F,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAuB,GAAG,OAAO,CAM7E;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAuB,GAAG,OAAO,CAO3E;AAED,kGAAkG;AAClG,wBAAgB,WAAW,CAAC,IAAI,GAAE,MAAuB,GAAG,MAAM,GAAG,SAAS,CAE7E;AAED,qGAAqG;AACrG,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,GAAE,MAAuB,GAAG,OAAO,CAM5F;AAED,uFAAuF;AACvF,wBAAgB,KAAK,CACnB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,EACxB,IAAI,GAAE,MAAuB,EAC7B,KAAK,UAAQ,GACZ,OAAO,CAQT;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAQ3D;AAED,wEAAwE;AACxE,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG7E"}