@c轨道/艺术

为交换代理商及其用户提供版本文件和文件:在Hono路由上架的轨道中心模块 @intx/hub-api,在可插件中保留 Postgres 和字节中的版本 ContentStore以及辅助车的船舶代理工具.

为什么?

1. 每个版本都保留. 文件或上传文件的每个版本都是新版本,其内容,字节和SHA-256摘要. expectedVersion 将修改变为比较和设定.
2. 就像任何枢纽路线一样. createArtifactRoutes 返回 a Hono<TenantEnv> 子应用程序。 读者只能是来电的房客 书写在中心 requireGrant。 。 。 .
3. 探员通过同一家商店写作. 一个运行扫描的路由集和一个侧车工具包让一个工作流程运行来创建,读取和修改其用户所看到的文物.
4. 移民安全回放. 每个SQL文件都具有"一能"性,在一个咨询锁下运行在每个靴子上,因此可以同时从几个复制品开始.

它没有UI,也没有物品商店: 宿主制造出文物,带来自己的 ContentStore 用于大型文件.

安装

bun add @corbits/artifacts \
  @intx/agent @intx/authz @intx/db @intx/hub-api @intx/types \
  drizzle-orm hono hono-openapi postgres

添加 @intx/agent 只有代理人使用侧车工具。 运行于节点QQ24.

快速启动

与 DATABASE_URL 指向运行过的中枢数据库 runArtifactMigrations (见 使用互换:

import {
  createArtifact,
  createArtifactDb,
  getArtifact,
} from "@corbits/artifacts";

const { db, close } = createArtifactDb(process.env.DATABASE_URL!);

const created = await db.transaction((tx) =>
  createArtifact(tx, {
    scope: { tenantId: "acme", principalId: "alice" },
    ownerPrincipalId: "alice",
    kind: "document",
    title: "Notes",
    content: "Hello",
    source: { origin: "manual" },
  }),
);
console.log(await getArtifact(db, created.id));
await close();

acme 财务报告和审定财务报表 alice 必须是中心的租户和校长。 它在第一版打印文物.

合适的话

互换 由AI代理作为委托人:拥有自己身份、权限和证书的账户。 其枢纽是多租户控制平面,它持有租户、本金和赠款(允许在资源上持有本金);其侧车是代理运行时间.

• 运行于 : 中心,作为其Hono应用的路线及其Postgres的桌子artifacts 计划.
• 插入到 : @intx/hub-api 路线和赠款, @intx/db (数量) DBConfig,以及 tenant 财务报告和审定财务报表 principal 作为FK目标的表格),以及 @intx/agent 工具在侧车.
• 与 : @corbits/mailbox 财务报告和审定财务报表 @corbits/memory,其他轨道中心模块,以及 @corbits/agent-token 为代理无记名标志.

参考文献

createArtifactRoutes(deps)

没有主, 除了列表和数答之外, 每一个路线 403另一个租户的文物,或者一个身份不明的,回答 404。在主机上设置一个上传和重审路径的请求-机构限制;在检查前缓冲机构 MAX_UPLOAD_BYTES。 。 。 .

每次写报告 contentSha256,与新版本存储的hex sha256:在UTF-8文本上,或者在文件的字节上传. POST /artifacts 财务报告和审定财务报表 POST /artifacts/upload 每件文物都带着它 POST /artifacts/:id/versions 返回旁边 artifactId 财务报告和审定财务报表 version这是 null 仅针对摘要存在前所写的版本.

createWorkflowArtifactRoutes(deps)

用于工作流程运行的运行范围路由,该路由以无记名符号和 x-workflow-run-address 标题而不是会话 .

beforeWrite({ scope, kind, write, content }) 得到运行范围, 文物种类, write 作为 { op: "create" } 或者说 { op: "revise", artifactId },且该版本在任何编辑后将保留内容。 它返回一个:

• { action: "allow" } 照常写作.
• { action: "refuse", code, message } 答题 422 与 { code, message },而代理工具错误是 message。 。 。 . code 必须匹配 /^[a-z0-9_]+$/· ; message 必须是 1 到 1 000 个字符.
• { action: "redirect", artifactId, expectedVersion? } 将创作变成对文物的修改 必须是同类的 在跑的房客,回答 200 联合国 { id, version }。该修订取了创建的名称。 丢失、存档或其他租户的文物答案 404和一个 stale expectedVersion 答题 409 告诉经纪人读读现有文物并修改.

任何其它决定, 重定向返回修改, 或重定向到另一类解答 500 写什么? 未检查二进制上传和链接文件 .

一个创造的检查不是连环化的:两个并发的创造都可以同时允许,因此,像"每个租户一个计划"这样的政策在跑步时仍然可以用两个计划来结束. 修改后的检查在持有文物行锁的交易内部进行,所以应当迅速,不得写出文物.

每笔笔写作POST /artifacts, (中文(简体) ), POST /artifacts/binary, (中文(简体) ), POST /artifacts/link-file, (中文(简体) ), PATCH /artifacts/:id回答问题 { data: { id, version, contentSha256 } },同一份摘要 租户路线报告。 对于 link-file 文摘覆盖存储 preview 文本( 当没有给出时为空),而不是工作空间文件 path。 。 。 .

runArtifactMigrations(config, { schema })

取同样的 DBConfig 财务报告和审定财务报表 schema 作为交换 runMigrations。 。 。 . schema 持有主机 tenant 财务报告和审定财务报表 principal 表格; 此软件包的表格总是输入 artifacts。 。 。 .

@corbits/artifacts/sidecar-bundle

artifacts 是一个 @intx/agent 3个工具的工具包。 他们把扫描过的路线叫做特工的 hub 证书.

• artifact_write 在未给出标识时, 从内容或工作空间文件路径创建 。 用一个ID来修改,或者用全文,或者用 edits:准确的段落,每个段落必须出现一次,否则没有文字. expectedVersion 如果新版本存在,则拒绝写入。 它回来了 { id, version, contentSha256 }。 。 。 .
• artifact_read 返回内容,一个过去版本 version区域 offset 财务报告和审定财务报表 limit。 。 。 .
• artifact_search 列出最新的文物,由 kind 由a query 与标题和内容相匹配.

使用互换

在互换后运行迁移, 挂载两套路由, 赠款 create 打开 artifact:* 给创造文物的负责人 给特工们工具包.

import { timeWindowEvaluator } from "@intx/authz";
import { createDB, createGrantStore, runMigrations } from "@intx/db";
import { createRequireGrant } from "@intx/hub-api";
import {
  createArtifactRoutes,
  InlineContentStore,
  runArtifactMigrations,
} from "@corbits/artifacts";

const dbConfig = {
  host: "localhost",
  port: 5432,
  user: "postgres",
  password: "postgres",
  database: "interchange",
};

await runMigrations(dbConfig, { schema: "public" });
await runArtifactMigrations(dbConfig, { schema: "public" });

const { db } = createDB(dbConfig);
const requireGrant = createRequireGrant({
  grantStore: createGrantStore(db),
  conditionRegistry: { time_window: timeWindowEvaluator },
});

export const artifactRoutes = createArtifactRoutes({
  db,
  contentStore: InlineContentStore,
  requireGrant,
});

挂载 artifactRoutes 在中枢应用程序 /api在枢纽的认证 和租户中间的软件.

对于特工,挂载 createWorkflowArtifactRoutes({ db, contentStore: InlineContentStore, resolveRunScope }) 时间 /api/workflow-artifacts。 。 。 . resolveRunScope 这是主机的 (bearerToken, runAddress) 从中心的工作流程中返回租户和校长的查询,或者 null。侧车工具呼叫 /api/workflow-artifacts添加到代理中并绑定其 hub 在您部署时, 证书为代理的中枢符 :

import { defineAgent, type InferencePreference } from "@intx/agent";
import { artifacts } from "@corbits/artifacts/sidecar-bundle";

export function buildAssistant(sources: readonly InferencePreference[]) {
  return defineAgent({
    id: "assistant",
    systemPrompt: "You help the team read and write shared artifacts.",
    capabilities: [],
    inference: { sources },
    tools: [artifacts],
  });
}

从0.1升级

• mountArtifacts(app, opts) 现在 createArtifactRoutes(deps),以及 mountWorkflowArtifacts(app, opts) 现在 createWorkflowArtifactRoutes(deps)双向挂载 app.route。 。 。 .
• POST /artifacts 财务报告和审定财务报表 POST /artifacts/upload 需求 create 打开 artifact:*升级将它授予每个已经在其租户中创造出文物的校长;将它授予新的校长.
• runArtifactMigrations(db) 现在 runArtifactMigrations(dbConfig, { schema }). 现有0.1.0数据升级在第一个靴子上.
• 那靴子掉了0.1.0的迁移分类账. 你不能回滚到0.1.0,0.1.0和0.2.0复制品不得共享数据库.
• 细细的桌子 web_site 援助者, SKILL_DRAFT_KIND, (中文(简体) ), windowContent 并拆除邮递路线和助手。 这个 mail_attachment_ref 表格已删除.
• 需要24号节点或更新.

从0.2升级

由地表分隔:AGENTS(侧车工具包)和HOSTS(路线和出口)的变化.

代理工具

侧车工具包倒塌了 5个更精细的涂装工具变成了3个. artifact_write 现在涵盖创建和链接(通过 edits编号 :content 其定义如下: { artifactId, version } 结果是一样的.

artifact_find_by_title 这不是一个滴入. 在0.2中它和标题相符 没错,只匹配标题,最多返回一个 { artifactId, version } (或作无. 在 0.3 时 artifact_search 对大小写不敏感的子字符串(ILKE)匹配 标题和内容,然后返回匹配的列表。 需要旧的准确标题、单结果语义的调用者必须在过滤结果后进行(比较) title 案件不敏感,并进行第一次精确的匹配.

搜索结果上限为每次呼叫50件文物. artifact_search 接受一个 cursor 财产(加) limit,上限为50),通过所有匹配的页面;回转先前的呼叫 nextCursor (保持相同的查询和类型)直到不返回.

主机

角色不变,但去掉了两条路线和一条出口:

• GET /artifacts/find → GET /artifacts?query=…时 query 是标题和内容上相同的对大小写不敏感的子字符串.
• GET /artifacts/:id/chunk → GET /artifacts/:id/read?offset&limit。 。 。 .
• readArtifactChunk 删除. findArtifactByTitle 财务报告和审定财务报表 linkFileArtifact 继续出口. README.md是因为 Reference 一节描述当前的路线和工具.

现在从软件包条目导出两个错误类别: VersionConflictError 答题 409 当 expectedVersion 已经僵化 ArtifactEditError 答题 400 当修改被拒绝时。 把它们找出来 准确的失败给用户.

许可证

LGPL - 2.1- 仅限