@glyphh-ai / glyphh
Ada for TypeScript和JavaScript：你在Ada Cloud中的模型 https://ada.glyphh.ai，使用API密钥调用。
Node 18或更高版本(或任何带有 fetch)，没有依赖关系。
npm install @glyphh-ai/glyphh
import { Ada, LimitError } from "@glyphh-ai/glyphh";
const ada = new Ada(); // GLYPHH_API_KEY from the environment; or new Ada({ key: "glyphh_ak_..." })
const d = await ada.decide("tickets", { ticket: { what: { plan: "pro", text: "charged twice" } } });
if (d.ask) await sendToAPerson(d); // a person should decide: d.outcome is the best guess, for them to see
else act(d.outcome); // d.probabilities, d.expected_cost, d.receipts: the precedents it stands on
const tickets = ada.model("tickets");
await tickets.record({ ticket: {...} }, "refund"); // a confirmed outcome: the next case learns from it
该密钥是在平台的API密钥页面(https://platform.glyphh.ai)，或者由克劳德通过象形文字
连接器;它在你的组织中起作用，并获得了许可。 GLYPHH_ADA_URL 移动地址（本地）
测试服务器)；3.0的 GLYPHH_RUNTIME_URL 和 GLYPHH_RUNTIME_KEY 仍在阅读。
从一无所有到做出决定
const tickets = await ada.createModel("tickets", spec); // the spec as JSON: layers, segments, roles, output
const job = await tickets.importFile("history.csv", { // a path (Node), or the bytes with { format }
mapping: { Plan: "ticket.what.plan", Result: "outcome" },
onProgress: (j) => console.log(j.state, j.percent),
});
console.log(job.result.added, job.result.refused, job.result.refusals.slice(0, 3));
const bt = await tickets.backtest([{ settings: { word_evidence: 0 }, name: "no word evidence" }], { holdout: { newest: 200 } });
await tickets.settings({ word_evidence: 0 }, { note: "cost 8% less on the last 200", backtest: bt.id }); // a new version
await tickets.activate(1); // and back
await tickets.export({ to: "tickets.zip" }); // everything, as a zip: never locked in
输入输出和联合
在 ada-1-2-beta，一个命名的输出 kind 它的答案是： score， noul， number， many 或者 choice
（默认值），以及 when 使输出成为联合的分支。以各自的方式记录(Outcome）; 读什么
它还补充道：
await tickets.recordMany([{ data, outcomes: { kind: "billing", refund: 120, urgent: true, tags: ["web"] } }]);
const d = await ada.decide("tickets", data, { outputs: ["kind", "severity", "refund", "urgent", "tags"] });
d.outputs?.urgent.p; // a noul's P(true)
d.outputs?.refund.value; // a number's expected value
d.outputs?.severity.applies; // false: a bug's severity does not arise for a billing case
d.outputs?.tags.outcome; // a many output's list
艾达版本
每个模型版本运行一个Ada版本，命名为 ada-<major>-<minor> （-beta 对于测试版)： ada-1-0 是
今天最新的稳定， ada-1-1-beta 一个测试版。模型的答案总是由它自己的Ada版本计算出来的；移动
另一个是你的选择，在你面前做了一个回测。
const { latest_stable, versions } = await ada.ada.versions(); // newest first: name, status, dates, notes, your models on it
const tickets = await ada.createModel("tickets", spec); // the latest stable; { ada: "ada-1-1-beta" } to opt in to a beta
const info = await tickets.info(); // info.ada, info.ada_status, info.ada_notice; each of versions() has .ada too
const bt = await tickets.backtest([], { ada: "ada-1-1-beta" }); // the active spec, learned and scored on that Ada
console.log(bt.result.active.cost, "->", bt.result.candidates[0].cost);
const moved = await tickets.upgrade({ ada: "ada-1-1-beta", note: "2 fewer wrong on the last 200", backtest: bt.id });
await tickets.activate(info.version); // and back, on the Ada it ran before
upgrade() 没有 ada 移动到最新的马厩；旧版本是降级的，允许保留。
测试版从来不是默认的。已弃用的版本在结束日期之前仍然应答，然后将模型移动到
最新稳定为您（从未离开无法回答）；当它运行一个时，或者在它被移动之后，客户端调用
new Ada({ onWarning }) (默认 console.warn（每个客户和通知一次）。被拒绝的名字永远不会被替换：
AdaVersionUnknownError， AdaVersionRetiredError， AdaVersionDeprecatedError （用于新型号或升级版）
目标), AdaBetaClosedError， AdaVersionUnavailableError，每个都有 ada 和 latest （最新的稳定，修复）。
SDK讲契约 SUPPORTED_CONTRACT (5)并被提出反对 SUPPORTED_ADA （ada-1-0， ada-1-1-beta);
服务器列表中的新名称按原样工作。一个服务器说了一个新的合约被拒绝，永远不会被读取
half-understood: ClientTooOldError （contract， supported)，对 npm install @glyphh-ai/glyphh@latest.
Ada | decide(model, data, { output, outputs, include: ["facts"], clearance }) （POST /v1/decide); models()， model(name)， createModel(name, spec, { ada })， deleteModel(name)； ada.versions()， ada.latestStable()； job(id)， wait(job, { timeout, onProgress })， download(job)； usage() |
AdaModel | info() （ada， ada_status， ada_notice)， spec()， setSpec(spec, { note, backtest })， settings() 和 settings(changes, { note, backtest })， versions() (每个都有 ada， kernel)， activate(version)， upgrade({ ada, note, backtest, wait })， delete()； recordMany(cases) （每条请求1000块）， grade(id, value, { output })， forget(id)； decide(data, ...)； learn()， learnJob()， calibrate()， backtest(candidates, { ada, holdout, output })； importFile(path or bytes, { format, mapping, partial, learn })， export({ format, to }) |
Decision | outcome， probabilities， expected_cost， ask， receipts， facts， outputs， model， version， ada;读起来是3.0 Result (status， data） |
AdaVersions | latest_stable， contract， versions (每 name， kernel， status， beta， open， released， deprecated， ends， changes_answers， aliases， summary， notes， models） |
Job | id， model， kind， state （awaiting， queued， running， done， failed)， percent， result， error， download， upload |
Usage | plan， month (UTC) YYYY-MM resets_at (YYYY-MM-DD), models， precedents （used， max)， requests （used， max， over， overage（过去一个月的基本版、专业版和团队版，拒绝免费版）； requests_per_second； null 是合同，没有上限 |
AdaError | code， message， status， detail， retryAfter， traceId;按代码输入： AuthError， LimitError （reason， used， max， plan， upgrade， resetsAt)， RateError （retryAfter 从Retry-After, max;在重试截止日期允许的范围内等待)， InvalidError， ModelMissingError， JobMissingError， SpecError， SpecLimitError， SpecReadingError， FewRolesError， MappingError， BusyError， NotReadyError， NoChangeError， IdempotencyError， VersionGoneError， AdaTimeoutError， UnavailableError， JobFailedError (一份结束的工作 failed)， AdaVersionError 和它的种类（上面）， ClientTooOldError |
每个长时间运行的调用都是一个作业，等待它的进程，除非 { wait: false }． 每次写都有一个
Idempotency-Key，因此客户端再次发送安全的内容：读或写，而Ada对于a是不可访问的
时刻(E_UNAVAILABLE， E_TIMEOUT（502到504），任何被拒绝的都是429，后退和 Retry-After，
最多可达 new Ada({ retryDeadline }) 秒（默认为30；0：不）。
SDK 3.0的调用仍然有效： record， query， facts， probabilities， learn 和 call(fn, inputs) 经历
POST /v1/runs 然后回答a Result （run_id， status， data,……)。云一次接一次，所以a
决策从不等待输入：它说 ask.
API和它的答案的形状在里面 contract/contract.json.
本地运行时：程序和cli
Runtime 是rrotor的客户端，您在自己的机器上安装的运行时(Docker映像，绑定到
127.0.0.1:7777;字形插件 rrotor 技能安装它从克劳德)。它不是艾达云：它托管你的
项目 (一个 glyphh.json 清单和 program.py，沙盒，有一个本地的秘密金库，cron时间表，一个
SQLite数据库和批准)和您的 综合领先指标 (一种程序， "kind": "cli"，每次运行一个命令
同样的沙盒)。字形只是授予它一个许可；没有，它就像社区一样运行。
import { Runtime } from "@glyphh-ai/glyphh";
const rt = new Runtime(); // RROTOR_URL or http://127.0.0.1:7777; RROTOR_TOKEN or ~/.glyphh/rrotor/token
await rt.deploy({ path: "./daily_sales" }); // the folder's HEAD commit (Node), or { repo, commit, token? }
let run = await rt.call("daily_sales", "start", { day: "2026-10-30" });
if (run.status === "needs_approval") run = await rt.approve(run.run_id); // only on the person's yes
await rt.setSecret("github", "GH_TOKEN", token); // kept encrypted on the runtime; never read back
const out = await rt.runCli("github", ["pr", "list"]); // out.data.exit_code, stdout, stderr
Runtime | programs()， program(name)， deploy({ path, commit? } | { repo, commit, token? } | { bundle, commit })； call(program, fn, inputs, { version, clearance })， resume(runId, answer)， approve(runId, approved?)， cancel(runId)， run(runId)， log(runId)， approvals()； secrets(program)， setSecret， deleteSecret； schedules()， pauseSchedule， resumeSchedule； clis()， runCli(cli, args, { stdin, files })； licence()， setLicence(key)， health() |
Run， CliOutput， RunInfo， Program， ProgramVersion， Approval， Secret， Schedule， Cli， Licence | 输入API的答案 |
RrotorError | 一个 AdaError 太;按代码输入： RrotorAuthError， RrotorForbiddenError， LocalOnlyError， ProgramMissingError， FunctionMissingError， RunMissingError， ScheduleMissingError， ManifestError， DeployError， InputsError， RunStateError， NotProgramError， NotCliError， CliDeniedError， NotHeadError， LicenceError， NotInPlanError； E_UNREACHABLE 当旋翼不运行时 |
当r转子暂时不可达时，再次发送读取；写的从来都不是。自承载旋翼是
new Runtime({ url: "https://rrotor.example.com", token: "<a runtime key>" })． 它的形状是
contract/runtime.json除了艾达的合同。
许可证
麻省理工学院(LICENSE）。