agentica 0.1.0

package/README.md

@@ -0,0 +1,67 @@
+# Agentica CLI Tool
+```bash
+npx agentica start <directory>
+npx agentica backend <directory>
+npx agentica client <directory> 
+```
+
+[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/wrtnlabs/agentica/blob/master/LICENSE)
+[![npm version](https://img.shields.io/npm/v/agentica.svg)](https://www.npmjs.com/package/agentica)
+[![Downloads](https://img.shields.io/npm/dm/agentica.svg)](https://www.npmjs.com/package/agentica)
+[![Build Status](https://github.com/wrtnlabs/agentica/workflows/build/badge.svg)](https://github.com/wrtnlabs/agentica/actions?query=workflow%3Abuild)
+
+Agentica CLI Tool cloning boilerplate project.
+
+  - `start`: a frontend application creating agent in browser
+  - `backend`: backend application serving the agent through websocket protocol
+  - `client`: frontend application connecting to above websocket server
+
+
+
+
+## Introduction
+![agentica-conceptual-diagram](https://github.com/user-attachments/assets/d7ebbd1f-04d3-4b0d-9e2a-234e29dd6c57)
+
+```typescript
+import { Agentica } from "@agentica/core";
+import typia from "typia";
+
+const agent = new Agentica({
+  controllers: [
+    await fetch(
+      "https://shopping-be.wrtn.ai/editor/swagger.json",
+    ).then(r => r.json()),
+    typia.llm.application<ShoppingCounselor>(),
+    typia.llm.application<ShoppingPolicy>(),
+    typia.llm.application<ShoppingSearchRag>(),
+  ],
+});
+await agent.conversate("I wanna buy MacBook Pro");
+```
+
+The simplest **Agentic AI** library, specialized in **LLM Function Calling**.
+
+Don't compose complicate agent graph or workflow, but just deliver **Swagger/OpenAPI** documents or **TypeScript class** types linearly to the `@agentica`. Then `@agentica` will do everything with the function calling.
+
+Look at the below demonstration, and feel how `@agentica` is easy and powerful.
+
+```typescript
+import { Agentica } from "@agentica/core";
+import typia from "typia";
+
+const agent = new Agentica({
+  controllers: [
+    await fetch(
+      "https://shopping-be.wrtn.ai/editor/swagger.json",
+    ).then(r => r.json()),
+    typia.llm.application<ShoppingCounselor>(),
+    typia.llm.application<ShoppingPolicy>(),
+    typia.llm.application<ShoppingSearchRag>(),
+  ],
+});
+await agent.conversate("I wanna buy MacBook Pro");
+```
+
+> https://github.com/user-attachments/assets/01604b53-aca4-41cb-91aa-3faf63549ea6
+>
+> Demonstration video of Shopping AI Chatbot

package/bin/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/bin/index.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const child_process_1 = __importDefault(require("child_process"));
+const fs_1 = __importDefault(require("fs"));
+const USAGE = `Wrong command has been detected. Use like below:
+
+npx agentica <type> <directory>
+
+  1. npx agentica start <directory>
+  2. npx agentica backend <directory>
+  3. npx agentica client <directory>
+`;
+const halt = (desc) => {
+    console.error(desc);
+    process.exit(-1);
+};
+const clone = (type, directory) => __awaiter(void 0, void 0, void 0, function* () {
+    const execute = (command) => {
+        console.log(`\n$ ${command}`);
+        child_process_1.default.execSync(command, { stdio: "inherit" });
+    };
+    // COPY PROJECTS
+    execute(`git clone https://github.com/wrtnlabs/agentica-template-${type} ${directory}`);
+    console.log(`cd "${directory}"`);
+    process.chdir(directory);
+    // INSTALL DEPENDENCIES
+    execute("npm install");
+    // BUILD TYPESCRIPT
+    execute("npm run build");
+    // DO TEST
+    execute("npm run test");
+    // REMOVE .GIT DIRECTORY
+    child_process_1.default.execSync("npx rimraf .git");
+    child_process_1.default.execSync("npx rimraf .github/dependabot.yml");
+});
+const main = () => __awaiter(void 0, void 0, void 0, function* () {
+    const [_v0, _v1, type, directory] = process.argv;
+    if (["start", "backend", "client", "standalone"].includes(type) === false ||
+        directory === undefined)
+        halt(USAGE);
+    else if (fs_1.default.existsSync(directory) === true)
+        halt("The target directory already exists.");
+    yield clone(type, directory);
+});
+main().catch((exp) => {
+    console.log(exp.message);
+    process.exit(-1);
+});
+//# sourceMappingURL=index.js.map

package/bin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AACA,kEAA+B;AAC/B,4CAAoB;AAEpB,MAAM,KAAK,GAAG;;;;;;;CAOb,CAAC;AAEF,MAAM,IAAI,GAAG,CAAC,IAAY,EAAS,EAAE;IACnC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,KAAK,GAAG,CAAO,IAAY,EAAE,SAAiB,EAAiB,EAAE;IACrE,MAAM,OAAO,GAAG,CAAC,OAAe,EAAQ,EAAE;QACxC,OAAO,CAAC,GAAG,CAAC,OAAO,OAAO,EAAE,CAAC,CAAC;QAC9B,uBAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC7C,CAAC,CAAC;IAEF,gBAAgB;IAChB,OAAO,CACL,2DAA2D,IAAI,IAAI,SAAS,EAAE,CAC/E,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,OAAO,SAAS,GAAG,CAAC,CAAC;IACjC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAEzB,uBAAuB;IACvB,OAAO,CAAC,aAAa,CAAC,CAAC;IAEvB,mBAAmB;IACnB,OAAO,CAAC,eAAe,CAAC,CAAC;IAEzB,UAAU;IACV,OAAO,CAAC,cAAc,CAAC,CAAC;IAExB,wBAAwB;IACxB,uBAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IAC/B,uBAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC,CAAC;AACnD,CAAC,CAAA,CAAC;AAEF,MAAM,IAAI,GAAG,GAAwB,EAAE;IACrC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IACjD,IACE,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,KAAK;QACrE,SAAS,KAAK,SAAS;QAEvB,IAAI,CAAC,KAAK,CAAC,CAAC;SACT,IAAI,YAAE,CAAC,UAAU,CAAC,SAAS,CAAC,KAAK,IAAI;QACxC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IAC/C,MAAM,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AAC/B,CAAC,CAAA,CAAC;AACF,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACzB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "agentica",
+  "version": "0.1.0",
+  "main": "bin/index.js",
+  "typings": "bin/index.d.ts",
+  "description": "Agentic AI Library specialized in LLM Function Calling",
+  "bin": {
+    "nestia": "bin/index.js"
+  },
+  "scripts": {
+    "build": "rimraf bin && tsc",
+    "dev": "rimraf bin && tsc --watch"
+  },
+  "author": "Wrtn Technologies",
+  "homepage": "https://wrtnlabs.io/agentica",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wrtnlabs/agentica"
+  },
+  "bugs": {
+    "url": "https://github.com/wrtnlabs/agentica/issues"
+  },
+  "keywords": [
+    "openai",
+    "chatgpt",
+    "anthropic",
+    "claude",
+    "ai",
+    "chatbot",
+    "nestia",
+    "swagger",
+    "openapi"
+  ],
+  "files": [
+    "README.md",
+    "LICENSE",
+    "package.json",
+    "bin",
+    "src"
+  ],
+  "dependencies": {
+    "commander": "^10.0.0",
+    "comment-json": "^4.2.3",
+    "inquirer": "^8.2.5",
+    "package-manager-detector": "^0.2.0"
+  },
+  "devDependencies": {
+    "@types/inquirer": "^9.0.3",
+    "@types/node": "^18.19.76",
+    "rimraf": "^6.0.1",
+    "typescript": "~5.8.2"
+  }
+}

package/src/index.ts

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+import cp from "child_process";
+import fs from "fs";
+
+const USAGE = `Wrong command has been detected. Use like below:
+
+npx agentica <type> <directory>
+
+  1. npx agentica start <directory>
+  2. npx agentica backend <directory>
+  3. npx agentica client <directory>
+`;
+
+const halt = (desc: string): never => {
+  console.error(desc);
+  process.exit(-1);
+};
+
+const clone = async (type: string, directory: string): Promise<void> => {
+  const execute = (command: string): void => {
+    console.log(`\n$ ${command}`);
+    cp.execSync(command, { stdio: "inherit" });
+  };
+
+  // COPY PROJECTS
+  execute(
+    `git clone https://github.com/wrtnlabs/agentica-template-${type} ${directory}`,
+  );
+  console.log(`cd "${directory}"`);
+  process.chdir(directory);
+
+  // INSTALL DEPENDENCIES
+  execute("npm install");
+
+  // BUILD TYPESCRIPT
+  execute("npm run build");
+
+  // DO TEST
+  execute("npm run test");
+
+  // REMOVE .GIT DIRECTORY
+  cp.execSync("npx rimraf .git");
+  cp.execSync("npx rimraf .github/dependabot.yml");
+};
+
+const main = async (): Promise<void> => {
+  const [_v0, _v1, type, directory] = process.argv;
+  if (
+    ["start", "backend", "client", "standalone"].includes(type) === false ||
+    directory === undefined
+  )
+    halt(USAGE);
+  else if (fs.existsSync(directory) === true)
+    halt("The target directory already exists.");
+  await clone(type, directory);
+};
+main().catch((exp) => {
+  console.log(exp.message);
+  process.exit(-1);
+});