@andrewkimjoseph/celina-sdk 0.9.1 → 0.9.2

package/build/a2a/agent-card.d.ts

@@ -1,7 +1,9 @@
 import { type CelinaA2ASkill } from "./skills.js";
 export interface CelinaAgentCardOptions {
-    /** Public base URL for the MCP host, e.g. https://mcp.usecelina.xyz */
-    baseUrl: string;
+    /** Public MCP host base URL for JSON-RPC execution, e.g. https://mcp.usecelina.xyz */
+    mcpBaseUrl?: string;
+    /** @deprecated Use mcpBaseUrl. Kept for backward compatibility. */
+    baseUrl?: string;
     /** Celina package version shown on the card */
     version: string;
 }

package/build/a2a/agent-card.js

@@ -5,8 +5,10 @@ export function buildCelinaA2ASkills() {
     return buildSkillsFromToolNames(getHostedMcpToolNames(), TOOL_CATEGORY_BY_NAME);
 }
 export function buildCelinaAgentCard(options) {
-    const base = options.baseUrl.replace(/\/$/, "");
-    const jsonRpcUrl = `${base}/api/a2a`;
+    const mcpBase = (options.mcpBaseUrl ??
+        options.baseUrl ??
+        "https://mcp.usecelina.xyz").replace(/\/$/, "");
+    const jsonRpcUrl = `${mcpBase}/api/a2a`;
     const skills = buildCelinaA2ASkills();
     return {
         name: "Celina",

package/build/a2a/agent-card.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-card.js","sourceRoot":"","sources":["../../src/a2a/agent-card.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,gBAAgB,GAEjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAoClC,MAAM,mBAAmB,GACvB,wKAAwK,CAAC;AAE3K,MAAM,UAAU,oBAAoB;IAClC,OAAO,wBAAwB,CAAC,qBAAqB,EAAE,EAAE,qBAAqB,CAAC,CAAC;AAClF,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAA+B;IAClE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,GAAG,IAAI,UAAU,CAAC;IACrC,MAAM,MAAM,GAAG,oBAAoB,EAAE,CAAC;IAEtC,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,mBAAmB;QAChC,eAAe,EAAE,OAAO;QACxB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,GAAG,EAAE,UAAU;QACf,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC7B,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACzB,CAAC,CAAC;QACH,YAAY,EAAE;YACZ,SAAS,EAAE,KAAK;YAChB,iBAAiB,EAAE,KAAK;SACzB;QACD,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;QACnC,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;QACpC,oBAAoB,EAAE;YACpB,EAAE,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE;SAC1C;QACD,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,eAAe,EAAE,gBAAgB;gBACjC,iBAAiB,EAAE;oBACjB,IAAI,EAAE,+BAA+B;oBACrC,SAAS,EAAE,oCAAoC;iBAChD;aACF;SACF;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"agent-card.js","sourceRoot":"","sources":["../../src/a2a/agent-card.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,gBAAgB,GAEjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAsClC,MAAM,mBAAmB,GACvB,wKAAwK,CAAC;AAE3K,MAAM,UAAU,oBAAoB;IAClC,OAAO,wBAAwB,CAAC,qBAAqB,EAAE,EAAE,qBAAqB,CAAC,CAAC;AAClF,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAA+B;IAClE,MAAM,OAAO,GAAG,CACd,OAAO,CAAC,UAAU;QAClB,OAAO,CAAC,OAAO;QACf,2BAA2B,CAC5B,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACrB,MAAM,UAAU,GAAG,GAAG,OAAO,UAAU,CAAC;IACxC,MAAM,MAAM,GAAG,oBAAoB,EAAE,CAAC;IAEtC,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,mBAAmB;QAChC,eAAe,EAAE,OAAO;QACxB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,GAAG,EAAE,UAAU;QACf,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC7B,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACzB,CAAC,CAAC;QACH,YAAY,EAAE;YACZ,SAAS,EAAE,KAAK;YAChB,iBAAiB,EAAE,KAAK;SACzB;QACD,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;QACnC,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;QACpC,oBAAoB,EAAE;YACpB,EAAE,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE;SAC1C;QACD,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,eAAe,EAAE,gBAAgB;gBACjC,iBAAiB,EAAE;oBACjB,IAAI,EAAE,+BAA+B;oBACrC,SAAS,EAAE,oCAAoC;iBAChD;aACF;SACF;KACF,CAAC;AACJ,CAAC"}

package/build/oasf/index.d.ts

@@ -0,0 +1,2 @@
+export { buildCelinaOasfRecord, buildCelinaOasfService, type CelinaOasfRecord, type CelinaOasfRecordLocator, type CelinaOasfRecordOptions, type CelinaOasfService, } from "./record.js";
+export { CELINA_OASF_DOMAINS, CELINA_OASF_SCHEMA_VERSION, CELINA_OASF_SKILLS, CELINA_OASF_VERSION, OASF_REPO_ENDPOINT, celinaOasfDomainsCsv, celinaOasfDomainSlugs, celinaOasfSkillSlugs, celinaOasfSkillsCsv, type OasfTaxonomyEntry, } from "./taxonomy.js";

package/build/oasf/index.js

@@ -0,0 +1,3 @@
+export { buildCelinaOasfRecord, buildCelinaOasfService, } from "./record.js";
+export { CELINA_OASF_DOMAINS, CELINA_OASF_SCHEMA_VERSION, CELINA_OASF_SKILLS, CELINA_OASF_VERSION, OASF_REPO_ENDPOINT, celinaOasfDomainsCsv, celinaOasfDomainSlugs, celinaOasfSkillSlugs, celinaOasfSkillsCsv, } from "./taxonomy.js";
+//# sourceMappingURL=index.js.map

package/build/oasf/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/oasf/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GAKvB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,GAEpB,MAAM,eAAe,CAAC"}

package/build/oasf/record.d.ts

@@ -0,0 +1,39 @@
+export interface CelinaOasfService {
+    name: "OASF";
+    endpoint: string;
+    version: string;
+    skills: string[];
+    domains: string[];
+}
+export interface CelinaOasfRecordLocator {
+    type: string;
+    urls: string[];
+}
+export interface CelinaOasfRecord {
+    name: string;
+    description: string;
+    version: string;
+    schema_version: string;
+    authors: string[];
+    created_at: string;
+    skills: Array<{
+        name: string;
+        id: number;
+    }>;
+    domains: Array<{
+        name: string;
+        id: number;
+    }>;
+    modules: unknown[];
+    locators: CelinaOasfRecordLocator[];
+}
+export interface CelinaOasfRecordOptions {
+    /** Package or release version shown on the record */
+    version?: string;
+    /** Public site base URL, e.g. https://usecelina.xyz */
+    siteBaseUrl?: string;
+    /** MCP host base URL for execution endpoints */
+    mcpBaseUrl?: string;
+}
+export declare function buildCelinaOasfService(): CelinaOasfService;
+export declare function buildCelinaOasfRecord(options?: CelinaOasfRecordOptions): CelinaOasfRecord;

package/build/oasf/record.js

@@ -0,0 +1,35 @@
+import { CELINA_OASF_SCHEMA_VERSION, CELINA_OASF_SKILLS, CELINA_OASF_DOMAINS, CELINA_OASF_VERSION, OASF_REPO_ENDPOINT, celinaOasfDomainSlugs, celinaOasfSkillSlugs, } from "./taxonomy.js";
+const DEFAULT_DESCRIPTION = "Celo mainnet specialist agent — hosted read-only access to balances, DeFi quotes, governance, staking, NFTs, and Self Agent ID verification via structured tool calls.";
+export function buildCelinaOasfService() {
+    return {
+        name: "OASF",
+        endpoint: OASF_REPO_ENDPOINT,
+        version: CELINA_OASF_VERSION,
+        skills: celinaOasfSkillSlugs(),
+        domains: celinaOasfDomainSlugs(),
+    };
+}
+export function buildCelinaOasfRecord(options = {}) {
+    const site = (options.siteBaseUrl ?? "https://usecelina.xyz").replace(/\/$/, "");
+    const mcp = (options.mcpBaseUrl ?? "https://mcp.usecelina.xyz").replace(/\/$/, "");
+    return {
+        name: "Celina",
+        description: DEFAULT_DESCRIPTION,
+        version: options.version ?? "0.9.2",
+        schema_version: CELINA_OASF_SCHEMA_VERSION,
+        authors: ["Celina <https://usecelina.xyz>"],
+        created_at: "2025-06-01T00:00:00Z",
+        skills: CELINA_OASF_SKILLS.map(({ name, id }) => ({ name, id })),
+        domains: CELINA_OASF_DOMAINS.map(({ name, id }) => ({ name, id })),
+        modules: [],
+        locators: [
+            { type: "source_code", urls: ["https://github.com/andrewkimjoseph/celina-sdk"] },
+            { type: "web", urls: [site] },
+            { type: "mcp", urls: [`${mcp}/api/mcp`] },
+            { type: "a2a", urls: [`${mcp}/api/a2a`] },
+            { type: "agent_card", urls: [`${site}/.well-known/agent-card.json`] },
+            { type: "registration", urls: [`${site}/agent.json`] },
+        ],
+    };
+}
+//# sourceMappingURL=record.js.map

package/build/oasf/record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.js","sourceRoot":"","sources":["../../src/oasf/record.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAqCvB,MAAM,mBAAmB,GACvB,wKAAwK,CAAC;AAE3K,MAAM,UAAU,sBAAsB;IACpC,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,kBAAkB;QAC5B,OAAO,EAAE,mBAAmB;QAC5B,MAAM,EAAE,oBAAoB,EAAE;QAC9B,OAAO,EAAE,qBAAqB,EAAE;KACjC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,UAAmC,EAAE;IAErC,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,WAAW,IAAI,uBAAuB,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACjF,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,2BAA2B,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAEnF,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,mBAAmB;QAChC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,OAAO;QACnC,cAAc,EAAE,0BAA0B;QAC1C,OAAO,EAAE,CAAC,gCAAgC,CAAC;QAC3C,UAAU,EAAE,sBAAsB;QAClC,MAAM,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAChE,OAAO,EAAE,mBAAmB,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAClE,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE;YACR,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,+CAA+C,CAAC,EAAE;YAChF,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE;YAC7B,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,GAAG,GAAG,UAAU,CAAC,EAAE;YACzC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,GAAG,GAAG,UAAU,CAAC,EAAE;YACzC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,8BAA8B,CAAC,EAAE;YACrE,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,aAAa,CAAC,EAAE;SACvD;KACF,CAAC;AACJ,CAAC"}

package/build/oasf/taxonomy.d.ts

@@ -0,0 +1,19 @@
+/**
+ * OASF v0.8.0 taxonomy slugs for Celina (hosted read-only Celo agent).
+ * IDs verified against https://schema.oasf.outshift.com/0.8.0/api/skill_categories
+ * and https://schema.oasf.outshift.com/0.8.0/api/domain_categories
+ */
+export declare const CELINA_OASF_VERSION = "0.8.0";
+export declare const OASF_REPO_ENDPOINT = "https://github.com/agntcy/oasf/";
+export declare const CELINA_OASF_SCHEMA_VERSION = "1.0.0";
+export interface OasfTaxonomyEntry {
+    name: string;
+    id: number;
+}
+/** EIP-8004 OASF service + hosted manifest skills */
+export declare const CELINA_OASF_SKILLS: readonly OasfTaxonomyEntry[];
+export declare const CELINA_OASF_DOMAINS: readonly OasfTaxonomyEntry[];
+export declare function celinaOasfSkillSlugs(): string[];
+export declare function celinaOasfDomainSlugs(): string[];
+export declare function celinaOasfSkillsCsv(): string;
+export declare function celinaOasfDomainsCsv(): string;

package/build/oasf/taxonomy.js

@@ -0,0 +1,46 @@
+/**
+ * OASF v0.8.0 taxonomy slugs for Celina (hosted read-only Celo agent).
+ * IDs verified against https://schema.oasf.outshift.com/0.8.0/api/skill_categories
+ * and https://schema.oasf.outshift.com/0.8.0/api/domain_categories
+ */
+export const CELINA_OASF_VERSION = "0.8.0";
+export const OASF_REPO_ENDPOINT = "https://github.com/agntcy/oasf/";
+export const CELINA_OASF_SCHEMA_VERSION = "1.0.0";
+/** EIP-8004 OASF service + hosted manifest skills */
+export const CELINA_OASF_SKILLS = [
+    {
+        name: "natural_language_processing/information_retrieval_synthesis/information_retrieval_synthesis_search",
+        id: 10306,
+    },
+    {
+        name: "natural_language_processing/information_retrieval_synthesis/fact_extraction",
+        id: 10301,
+    },
+    {
+        name: "natural_language_processing/analytical_reasoning/fact_verification",
+        id: 10703,
+    },
+    { name: "tool_interaction/api_schema_understanding", id: 1401 },
+    { name: "tool_interaction/tool_use_planning", id: 1403 },
+    { name: "governance_compliance/compliance_assessment", id: 1302 },
+];
+export const CELINA_OASF_DOMAINS = [
+    { name: "technology/blockchain", id: 109 },
+    { name: "technology/blockchain/cryptocurrency", id: 10901 },
+    { name: "technology/blockchain/defi", id: 10902 },
+    { name: "technology/blockchain/smart_contracts", id: 10903 },
+    { name: "finance_and_business/investment_services", id: 203 },
+];
+export function celinaOasfSkillSlugs() {
+    return CELINA_OASF_SKILLS.map((entry) => entry.name);
+}
+export function celinaOasfDomainSlugs() {
+    return CELINA_OASF_DOMAINS.map((entry) => entry.name);
+}
+export function celinaOasfSkillsCsv() {
+    return celinaOasfSkillSlugs().join(", ");
+}
+export function celinaOasfDomainsCsv() {
+    return celinaOasfDomainSlugs().join(", ");
+}
+//# sourceMappingURL=taxonomy.js.map

package/build/oasf/taxonomy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"taxonomy.js","sourceRoot":"","sources":["../../src/oasf/taxonomy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAO,CAAC;AAC3C,MAAM,CAAC,MAAM,kBAAkB,GAAG,iCAAiC,CAAC;AACpE,MAAM,CAAC,MAAM,0BAA0B,GAAG,OAAO,CAAC;AAOlD,qDAAqD;AACrD,MAAM,CAAC,MAAM,kBAAkB,GAAiC;IAC9D;QACE,IAAI,EAAE,oGAAoG;QAC1G,EAAE,EAAE,KAAK;KACV;IACD;QACE,IAAI,EAAE,6EAA6E;QACnF,EAAE,EAAE,KAAK;KACV;IACD;QACE,IAAI,EAAE,oEAAoE;QAC1E,EAAE,EAAE,KAAK;KACV;IACD,EAAE,IAAI,EAAE,2CAA2C,EAAE,EAAE,EAAE,IAAI,EAAE;IAC/D,EAAE,IAAI,EAAE,oCAAoC,EAAE,EAAE,EAAE,IAAI,EAAE;IACxD,EAAE,IAAI,EAAE,6CAA6C,EAAE,EAAE,EAAE,IAAI,EAAE;CAClE,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAiC;IAC/D,EAAE,IAAI,EAAE,uBAAuB,EAAE,EAAE,EAAE,GAAG,EAAE;IAC1C,EAAE,IAAI,EAAE,sCAAsC,EAAE,EAAE,EAAE,KAAK,EAAE;IAC3D,EAAE,IAAI,EAAE,4BAA4B,EAAE,EAAE,EAAE,KAAK,EAAE;IACjD,EAAE,IAAI,EAAE,uCAAuC,EAAE,EAAE,EAAE,KAAK,EAAE;IAC5D,EAAE,IAAI,EAAE,0CAA0C,EAAE,EAAE,EAAE,GAAG,EAAE;CAC9D,CAAC;AAEF,MAAM,UAAU,oBAAoB;IAClC,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,mBAAmB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,oBAAoB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,qBAAqB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andrewkimjoseph/celina-sdk",
-  "version": "0.9.1",
+  "version": "0.9.2",
   "description": "Celina SDK — Celo mainnet reads and unsigned transaction preparation for frontend apps.",
   "type": "module",
   "sideEffects": false,
@@ -26,6 +26,11 @@
       "types": "./build/a2a/index.d.ts",
       "import": "./build/a2a/index.js",
       "default": "./build/a2a/index.js"
+    },
+    "./oasf": {
+      "types": "./build/oasf/index.d.ts",
+      "import": "./build/oasf/index.js",
+      "default": "./build/oasf/index.js"
     }
   },
   "files": [
@@ -48,6 +53,9 @@
     "docs:build": "npm run docs:api && npm run docs:summary",
     "generate:website-tools": "node scripts/generate-website-tools.mjs",
     "generate:a2a-card": "node scripts/generate-a2a-card.mjs",
+    "generate:oasf-manifest": "node scripts/generate-oasf-manifest.mjs",
+    "generate:agent-json": "node scripts/generate-agent-json.mjs",
+    "generate:discovery": "npm run generate:a2a-card && npm run generate:oasf-manifest && npm run generate:agent-json",
     "prepublishOnly": "npm run build",
     "prepare": "npm run build"
   },