@absolutejs/artifacts 0.0.4 → 0.0.5

package/dist/manifest.js

@@ -14,14 +14,19 @@ var __export = (target, all) => {
       set: __exportSetter.bind(all, name)
     });
 };
-var defineManifest = () => (manifest) => {
-  const defined = manifest;
-  return defined;
+var defineManifest = () => (manifest) => manifest;
+var literal = (value) => value;
+var RUNTIME_KIND = literal("runtime");
+var WORKSPACE_KIND = literal("workspace");
+var toolFactory = () => {
+  function runtime(definition) {
+    return { kind: RUNTIME_KIND, ...definition };
+  }
+  function workspace(definition) {
+    return { kind: WORKSPACE_KIND, ...definition };
+  }
+  return { runtime, workspace };
 };
-var toolFactory = () => ({
-  runtime: (definition) => ({ kind: "runtime", ...definition }),
-  workspace: (definition) => ({ kind: "workspace", ...definition })
-});
 function IsAsyncIterator(value) {
   return IsObject(value) && globalThis.Symbol.asyncIterator in value;
 }
@@ -759,7 +764,7 @@ function String2(options) {
 function* FromUnion(syntax) {
   const trim = syntax.trim().replace(/"|'/g, "");
   return trim === "boolean" ? yield Boolean() : trim === "number" ? yield Number2() : trim === "bigint" ? yield BigInt2() : trim === "string" ? yield String2() : yield (() => {
-    const literals = trim.split("|").map((literal) => Literal(literal.trim()));
+    const literals = trim.split("|").map((literal2) => Literal(literal2.trim()));
     return literals.length === 0 ? Never() : literals.length === 1 ? literals[0] : UnionEvaluated(literals);
   })();
 }
@@ -3467,10 +3472,10 @@ function ScoreUnion(schema, references, value) {
     const keys = Object.getOwnPropertyNames(value);
     const entries = Object.entries(object.properties);
     return entries.reduce((acc, [key, schema2]) => {
-      const literal = schema2[Kind] === "Literal" && schema2.const === value[key] ? 100 : 0;
+      const literal2 = schema2[Kind] === "Literal" && schema2.const === value[key] ? 100 : 0;
       const checks = Check(schema2, references, value[key]) ? 10 : 0;
       const exists = keys.includes(key) ? 1 : 0;
-      return acc + (literal + checks + exists);
+      return acc + (literal2 + checks + exists);
     }, 0);
   } else if (schema[Kind] === "Union") {
     const schemas = schema.anyOf.map((schema2) => Deref(schema2, references));
@@ -5807,7 +5812,13 @@ var wiringSnippet = Type.Object({
     Type.Literal("server-plugin")
   ]))
 });
-var clientFrameworks = ["angular", "client", "react", "svelte", "vue"];
+var clientFrameworks = [
+  "angular",
+  "client",
+  "react",
+  "svelte",
+  "vue"
+];
 var wiringRecipe = Type.Object({
   client: Type.Optional(Type.Partial(Type.Object(Object.fromEntries(clientFrameworks.map((framework) => [framework, wiringSnippet]))))),
   description: Type.Optional(Type.String()),
@@ -5872,8 +5883,47 @@ var toolAnnotations = Type.Object({
   readOnlyHint: Type.Optional(Type.Boolean()),
   title: Type.Optional(Type.String())
 });
+var toolAuthorization = Type.Object({
+  approval: Type.Union([
+    Type.Literal("always"),
+    Type.Literal("never"),
+    Type.Literal("policy")
+  ]),
+  audience: Type.Union([
+    Type.Literal("admin"),
+    Type.Literal("authenticated"),
+    Type.Literal("owner"),
+    Type.Literal("public")
+  ]),
+  compensatingTool: Type.Optional(Type.String({ pattern: TOOL_NAME_PATTERN.source })),
+  destinationFields: Type.Optional(Type.Array(Type.String({ minLength: 1 }), { minItems: 1 })),
+  destinations: Type.Optional(Type.Array(Type.String({ minLength: 1 }), { minItems: 1 })),
+  effects: Type.Array(Type.String({ minLength: 1 }), { minItems: 1 }),
+  idempotency: Type.Optional(Type.Union([
+    Type.Object({
+      field: Type.String({ minLength: 1 }),
+      mode: Type.Literal("field")
+    }),
+    Type.Object({ mode: Type.Literal("host") }),
+    Type.Object({ mode: Type.Literal("resource") })
+  ])),
+  requiredScopes: Type.Optional(Type.Array(Type.String({ minLength: 1 }), { minItems: 1 })),
+  resource: Type.Optional(Type.Object({
+    idField: Type.Optional(Type.String({ minLength: 1 })),
+    ownerIdField: Type.Optional(Type.String({ minLength: 1 })),
+    tenantIdField: Type.Optional(Type.String({ minLength: 1 })),
+    type: Type.String({ minLength: 1 })
+  })),
+  reversible: Type.Optional(Type.Boolean()),
+  spend: Type.Optional(Type.Object({
+    amountMinorField: Type.String({ minLength: 1 }),
+    currencyField: Type.String({ minLength: 1 }),
+    maximumAmountMinor: Type.Optional(Type.Integer({ minimum: 0 }))
+  }))
+});
 var serializedTool = Type.Object({
   annotations: Type.Optional(toolAnnotations),
+  authorization: Type.Optional(toolAuthorization),
   capabilities: Type.Optional(Type.Array(Type.Union([
     Type.Literal("exec"),
     Type.Literal("glob"),
@@ -5885,7 +5935,15 @@ var serializedTool = Type.Object({
   kind: Type.Union([Type.Literal("runtime"), Type.Literal("workspace")])
 });
 var manifestSchema = Type.Object({
-  contract: Type.Literal(1),
+  contract: Type.Union([Type.Literal(1), Type.Literal(2)]),
+  discovery: Type.Optional(Type.Object({
+    audiences: Type.Optional(Type.Array(Type.String({ minLength: 1 }))),
+    certificationUrl: Type.Optional(Type.String()),
+    intents: Type.Optional(Type.Array(Type.String({ minLength: 1 }))),
+    keywords: Type.Optional(Type.Array(Type.String({ minLength: 1 }))),
+    protocols: Type.Optional(Type.Array(Type.String({ minLength: 1 }))),
+    url: Type.Optional(Type.String())
+  })),
   identity: Type.Object({
     accent: Type.Optional(Type.String({ pattern: "^#[0-9a-fA-F]{3,8}$" })),
     category: Type.String({ minLength: 1 }),
@@ -5895,7 +5953,9 @@ var manifestSchema = Type.Object({
       svg: Type.Optional(Type.String()),
       url: Type.Optional(Type.String())
     })),
-    name: Type.String({ pattern: "^(@[a-z0-9-~][a-z0-9-._~]*/)?[a-z0-9-~][a-z0-9-._~]*$" }),
+    name: Type.String({
+      pattern: "^(@[a-z0-9-~][a-z0-9-._~]*/)?[a-z0-9-~][a-z0-9-._~]*$"
+    }),
     tagline: Type.String({ minLength: 1 })
   }),
   implements: Type.Optional(Type.Array(adapterImplementation)),
@@ -5917,7 +5977,7 @@ var manifestSchema = Type.Object({
 import { Type as Type2 } from "@sinclair/typebox";
 var tool = toolFactory();
 var manifest = defineManifest()({
-  contract: 1,
+  contract: 2,
   identity: {
     accent: "#8b5cf6",
     category: "ai",
@@ -5939,6 +5999,17 @@ var manifest = defineManifest()({
   tools: {
     artifact_get: tool.runtime({
       annotations: { readOnlyHint: true },
+      authorization: {
+        approval: "never",
+        audience: "owner",
+        effects: ["read"],
+        requiredScopes: ["artifacts:read"],
+        resource: {
+          idField: "artifactId",
+          ownerIdField: "ownerId",
+          type: "artifact"
+        }
+      },
       description: "Open one artifact owned by a user.",
       handler: async ({ artifactId, ownerId }, service) => JSON.stringify(await service.get(ownerId, artifactId)),
       input: Type2.Object({
@@ -5948,6 +6019,13 @@ var manifest = defineManifest()({
     }),
     artifact_list: tool.runtime({
       annotations: { readOnlyHint: true },
+      authorization: {
+        approval: "never",
+        audience: "owner",
+        effects: ["read"],
+        requiredScopes: ["artifacts:read"],
+        resource: { ownerIdField: "ownerId", type: "artifact" }
+      },
       description: "List artifacts owned by a user.",
       handler: async ({ kind, ownerId }, service) => JSON.stringify(await service.list(ownerId, { kind })),
       input: Type2.Object({
@@ -5957,6 +6035,17 @@ var manifest = defineManifest()({
     }),
     artifact_history: tool.runtime({
       annotations: { readOnlyHint: true },
+      authorization: {
+        approval: "never",
+        audience: "owner",
+        effects: ["read"],
+        requiredScopes: ["artifacts:read"],
+        resource: {
+          idField: "artifactId",
+          ownerIdField: "ownerId",
+          type: "artifact-revision"
+        }
+      },
       description: "List immutable revisions of one artifact owned by a user.",
       handler: async ({ artifactId, ownerId }, service) => JSON.stringify(await service.listRevisions(ownerId, artifactId)),
       input: Type2.Object({
@@ -5965,6 +6054,19 @@ var manifest = defineManifest()({
       })
     }),
     artifact_restore: tool.runtime({
+      authorization: {
+        approval: "policy",
+        audience: "owner",
+        effects: ["write"],
+        idempotency: { mode: "host" },
+        requiredScopes: ["artifacts:write"],
+        resource: {
+          idField: "artifactId",
+          ownerIdField: "ownerId",
+          type: "artifact-revision"
+        },
+        reversible: false
+      },
       description: "Restore an old artifact revision as a new private draft.",
       handler: async ({ artifactId, ownerId, revision }, service) => JSON.stringify(await service.restore(ownerId, artifactId, revision)),
       input: Type2.Object({

package/dist/manifest.json

@@ -1,5 +1,5 @@
 {
-	"contract": 1,
+	"contract": 2,
 	"identity": {
 		"accent": "#8b5cf6",
 		"category": "ai",
@@ -53,6 +53,21 @@
 			"annotations": {
 				"readOnlyHint": true
 			},
+			"authorization": {
+				"approval": "never",
+				"audience": "owner",
+				"effects": [
+					"read"
+				],
+				"requiredScopes": [
+					"artifacts:read"
+				],
+				"resource": {
+					"idField": "artifactId",
+					"ownerIdField": "ownerId",
+					"type": "artifact"
+				}
+			},
 			"description": "Open one artifact owned by a user.",
 			"input": {
 				"type": "object",
@@ -77,6 +92,20 @@
 			"annotations": {
 				"readOnlyHint": true
 			},
+			"authorization": {
+				"approval": "never",
+				"audience": "owner",
+				"effects": [
+					"read"
+				],
+				"requiredScopes": [
+					"artifacts:read"
+				],
+				"resource": {
+					"ownerIdField": "ownerId",
+					"type": "artifact"
+				}
+			},
 			"description": "List artifacts owned by a user.",
 			"input": {
 				"type": "object",
@@ -100,6 +129,21 @@
 			"annotations": {
 				"readOnlyHint": true
 			},
+			"authorization": {
+				"approval": "never",
+				"audience": "owner",
+				"effects": [
+					"read"
+				],
+				"requiredScopes": [
+					"artifacts:read"
+				],
+				"resource": {
+					"idField": "artifactId",
+					"ownerIdField": "ownerId",
+					"type": "artifact-revision"
+				}
+			},
 			"description": "List immutable revisions of one artifact owned by a user.",
 			"input": {
 				"type": "object",
@@ -121,6 +165,25 @@
 			"kind": "runtime"
 		},
 		"artifact_restore": {
+			"authorization": {
+				"approval": "policy",
+				"audience": "owner",
+				"effects": [
+					"write"
+				],
+				"idempotency": {
+					"mode": "host"
+				},
+				"requiredScopes": [
+					"artifacts:write"
+				],
+				"resource": {
+					"idField": "artifactId",
+					"ownerIdField": "ownerId",
+					"type": "artifact-revision"
+				},
+				"reversible": false
+			},
 			"description": "Restore an old artifact revision as a new private draft.",
 			"input": {
 				"type": "object",

package/dist/src/manifest.d.ts

@@ -1,4 +1,4 @@
-export declare const manifest: import("@absolutejs/manifest").PackageManifest<Record<string, never>, {
+export declare const manifest: Omit<import("@absolutejs/manifest").PackageManifest<Record<string, never>, {
     archive: (ownerId: string, artifactId: string) => Promise<import("./types").ArtifactRecord>;
     attach: (ownerId: string, artifactId: string, input: import("./types").ArtifactAssetWriteInput, expectedRevision?: number) => Promise<import("./types").ArtifactRecord>;
     attachBundle: (ownerId: string, artifactId: string, inputs: import("./types").ArtifactAssetWriteInput[], expectedRevision?: number) => Promise<import("./types").ArtifactRecord>;
@@ -30,4 +30,76 @@ export declare const manifest: import("@absolutejs/manifest").PackageManifest<Re
     restore: (ownerId: string, artifactId: string, revision: number, expectedRevision?: number) => Promise<import("./types").ArtifactRecord>;
     unpublish: (ownerId: string, artifactId: string) => Promise<import("./types").ArtifactRecord>;
     update: (ownerId: string, artifactId: string, input: import("./types").ArtifactUpdateInput) => Promise<import("./types").ArtifactRecord>;
-}>;
+}>, "contract" | "settings" | "tools"> & (({
+    contract: 1;
+    tools?: Record<string, import("@absolutejs/manifest").LegacyManifestTool<{
+        archive: (ownerId: string, artifactId: string) => Promise<import("./types").ArtifactRecord>;
+        attach: (ownerId: string, artifactId: string, input: import("./types").ArtifactAssetWriteInput, expectedRevision?: number) => Promise<import("./types").ArtifactRecord>;
+        attachBundle: (ownerId: string, artifactId: string, inputs: import("./types").ArtifactAssetWriteInput[], expectedRevision?: number) => Promise<import("./types").ArtifactRecord>;
+        collectAssetGarbage: (input: {
+            dryRun?: boolean;
+            minimumAgeMs?: number;
+        }) => Promise<import("./types").ArtifactGarbageCollectionResult>;
+        create: (ownerId: string, input: import("./types").ArtifactCreateInput) => Promise<import("./types").ArtifactRecord>;
+        createBundle: (ownerId: string, input: import("./types").ArtifactBundleCreateInput) => Promise<import("./types").ArtifactRecord>;
+        detach: (ownerId: string, artifactId: string, assetId: string, expectedRevision?: number) => Promise<import("./types").ArtifactRecord>;
+        get: (ownerId: string, artifactId: string) => Promise<import("./types").ArtifactRecord>;
+        getIndexingState: (ownerId: string, artifactId: string) => Promise<import("./types").ArtifactIndexingState | null>;
+        getRevision: (ownerId: string, artifactId: string, revision: number) => Promise<Readonly<import("./types").ArtifactRecord<unknown>>>;
+        list: (ownerId: string, query?: import("./types").ArtifactListQuery) => Promise<import("./types").ArtifactRecord[]>;
+        listEvents: (query?: import("./types").ArtifactEventQuery) => Promise<import("./types").ArtifactEvent[]>;
+        listRevisions: (ownerId: string, artifactId: string) => Promise<Readonly<import("./types").ArtifactRecord<unknown>>[]>;
+        markEventProcessed: (eventId: string, processedAt?: string) => Promise<boolean>;
+        markIndexing: (ownerId: string, artifactId: string, input: {
+            documentIds?: string[];
+            error?: string;
+            revision: number;
+            status: import("./types").ArtifactIndexingStatus;
+        }) => Promise<import("./types").ArtifactIndexingState>;
+        publish: (ownerId: string, artifactId: string, input?: import("./types").ArtifactPublishInput) => Promise<import("./types").ArtifactRecord>;
+        readAsset: (ownerId: string, artifactId: string, assetId: string) => Promise<{
+            asset: import("./types").ArtifactAssetReference;
+            data: Uint8Array<ArrayBufferLike>;
+        }>;
+        restore: (ownerId: string, artifactId: string, revision: number, expectedRevision?: number) => Promise<import("./types").ArtifactRecord>;
+        unpublish: (ownerId: string, artifactId: string) => Promise<import("./types").ArtifactRecord>;
+        update: (ownerId: string, artifactId: string, input: import("./types").ArtifactUpdateInput) => Promise<import("./types").ArtifactRecord>;
+    }>> | undefined;
+} | {
+    contract: 2;
+    tools?: Record<string, import("@absolutejs/manifest").AuthorizedManifestTool<{
+        archive: (ownerId: string, artifactId: string) => Promise<import("./types").ArtifactRecord>;
+        attach: (ownerId: string, artifactId: string, input: import("./types").ArtifactAssetWriteInput, expectedRevision?: number) => Promise<import("./types").ArtifactRecord>;
+        attachBundle: (ownerId: string, artifactId: string, inputs: import("./types").ArtifactAssetWriteInput[], expectedRevision?: number) => Promise<import("./types").ArtifactRecord>;
+        collectAssetGarbage: (input: {
+            dryRun?: boolean;
+            minimumAgeMs?: number;
+        }) => Promise<import("./types").ArtifactGarbageCollectionResult>;
+        create: (ownerId: string, input: import("./types").ArtifactCreateInput) => Promise<import("./types").ArtifactRecord>;
+        createBundle: (ownerId: string, input: import("./types").ArtifactBundleCreateInput) => Promise<import("./types").ArtifactRecord>;
+        detach: (ownerId: string, artifactId: string, assetId: string, expectedRevision?: number) => Promise<import("./types").ArtifactRecord>;
+        get: (ownerId: string, artifactId: string) => Promise<import("./types").ArtifactRecord>;
+        getIndexingState: (ownerId: string, artifactId: string) => Promise<import("./types").ArtifactIndexingState | null>;
+        getRevision: (ownerId: string, artifactId: string, revision: number) => Promise<Readonly<import("./types").ArtifactRecord<unknown>>>;
+        list: (ownerId: string, query?: import("./types").ArtifactListQuery) => Promise<import("./types").ArtifactRecord[]>;
+        listEvents: (query?: import("./types").ArtifactEventQuery) => Promise<import("./types").ArtifactEvent[]>;
+        listRevisions: (ownerId: string, artifactId: string) => Promise<Readonly<import("./types").ArtifactRecord<unknown>>[]>;
+        markEventProcessed: (eventId: string, processedAt?: string) => Promise<boolean>;
+        markIndexing: (ownerId: string, artifactId: string, input: {
+            documentIds?: string[];
+            error?: string;
+            revision: number;
+            status: import("./types").ArtifactIndexingStatus;
+        }) => Promise<import("./types").ArtifactIndexingState>;
+        publish: (ownerId: string, artifactId: string, input?: import("./types").ArtifactPublishInput) => Promise<import("./types").ArtifactRecord>;
+        readAsset: (ownerId: string, artifactId: string, assetId: string) => Promise<{
+            asset: import("./types").ArtifactAssetReference;
+            data: Uint8Array<ArrayBufferLike>;
+        }>;
+        restore: (ownerId: string, artifactId: string, revision: number, expectedRevision?: number) => Promise<import("./types").ArtifactRecord>;
+        unpublish: (ownerId: string, artifactId: string) => Promise<import("./types").ArtifactRecord>;
+        update: (ownerId: string, artifactId: string, input: import("./types").ArtifactUpdateInput) => Promise<import("./types").ArtifactRecord>;
+    }>> | undefined;
+}) & {
+    settings: import("@sinclair/typebox").TObject<{}>;
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@absolutejs/artifacts",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "Typed, versioned artifacts for AI products — schemas, lifecycle, storage, rendering, publishing, revisions, and agent tools without prescribing a database or host.",
   "author": "Alex Kahn",
   "license": "BUSL-1.1",
@@ -31,7 +31,7 @@
     "access": "public"
   },
   "absolutejs": {
-    "manifestContract": 1
+    "manifestContract": 2
   },
   "exports": {
     ".": {
@@ -52,7 +52,7 @@
     }
   },
   "dependencies": {
-    "@absolutejs/manifest": "^0.1.0",
+    "@absolutejs/manifest": "^0.4.0",
     "@sinclair/typebox": "^0.34.0"
   },
   "peerDependencies": {