@agentclutch/action-card 0.7.3-alpha.0

package/LICENSE

@@ -0,0 +1,3 @@
+Apache-2.0 license placeholder.
+
+The full Apache License 2.0 text will be added before the first release.

package/README.md

@@ -0,0 +1,27 @@
+# @agentclutch/action-card
+
+TypeScript types, schemas, builders, and validation for AgentClutch Action Cards.
+
+This package is part of [AgentClutch](https://github.com/MelaBuilt-AI/agentclutch): the local-first Action Card and takeover UX layer for consequential AI agent actions.
+
+## Status
+
+`0.7.3-alpha.0` is prepared as the first npm alpha version. Publish with the `alpha` dist-tag only until AgentClutch is stable.
+
+## Install
+
+```bash
+pnpm add @agentclutch/action-card@alpha
+```
+
+## Usage
+
+```ts
+import { buildActionCard } from "@agentclutch/action-card";
+```
+
+## Package role
+
+Action Card types, schema, builders, and validation.
+
+See the root AgentClutch README and `docs/quickstart.md` for full setup, demos, and caveats.

package/dist/builders.d.ts

@@ -0,0 +1,16 @@
+import type { ActionCard, AgentDescriptor, ConsequenceDescriptor, EvidenceItem, ISODateTime, JsonObject, ProposedAction, RiskDescriptor, UserOption } from "./types.js";
+export interface BuildActionCardInput {
+    id: string;
+    run_id: string;
+    agent: AgentDescriptor;
+    proposed_action: ProposedAction;
+    consequence: ConsequenceDescriptor;
+    risk: RiskDescriptor;
+    evidence?: EvidenceItem[];
+    user_options?: UserOption[];
+    created_at?: ISODateTime;
+    expires_at?: ISODateTime;
+    metadata?: JsonObject;
+}
+export declare function buildActionCard(input: BuildActionCardInput): ActionCard;
+//# sourceMappingURL=builders.d.ts.map

package/dist/builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../src/builders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,YAAY,EACZ,WAAW,EACX,UAAU,EACV,cAAc,EACd,cAAc,EACd,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,eAAe,CAAC;IACvB,eAAe,EAAE,cAAc,CAAC;IAChC,WAAW,EAAE,qBAAqB,CAAC;IACnC,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAC1B,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC;IAC5B,UAAU,CAAC,EAAE,WAAW,CAAC;IACzB,UAAU,CAAC,EAAE,WAAW,CAAC;IACzB,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,UAAU,CAoBvE"}

package/dist/builders.js

@@ -0,0 +1,22 @@
+export function buildActionCard(input) {
+    return {
+        type: "agentclutch.action_card.v0",
+        id: input.id,
+        run_id: input.run_id,
+        created_at: input.created_at ?? new Date().toISOString(),
+        agent: input.agent,
+        proposed_action: input.proposed_action,
+        consequence: input.consequence,
+        risk: input.risk,
+        evidence: input.evidence ?? [],
+        user_options: input.user_options ?? [
+            "approve_once",
+            "edit_fields",
+            "take_wheel",
+            "block"
+        ],
+        ...(input.expires_at === undefined ? {} : { expires_at: input.expires_at }),
+        ...(input.metadata === undefined ? {} : { metadata: input.metadata })
+    };
+}
+//# sourceMappingURL=builders.js.map

package/dist/builders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.js","sourceRoot":"","sources":["../src/builders.ts"],"names":[],"mappings":"AA0BA,MAAM,UAAU,eAAe,CAAC,KAA2B;IACzD,OAAO;QACL,IAAI,EAAE,4BAA4B;QAClC,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACxD,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE;QAC9B,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI;YAClC,cAAc;YACd,aAAa;YACb,YAAY;YACZ,OAAO;SACR;QACD,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC;QAC3E,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;KACtE,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./types.js";
+export * from "./schema.js";
+export * from "./builders.js";
+export * from "./validators.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from "./types.js";
+export * from "./schema.js";
+export * from "./builders.js";
+export * from "./validators.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC"}