agpk

library1.2.4jsnpmunverified

Agentics Package Manager (AGPK) is a JavaScript toolchain that bundles, encrypts with AES-256-CTR, and compiles JavaScript/TypeScript projects into native binaries. Version 1.2.4 current. It also functions as a full package manager with dependency resolution, global store, and lockfile management, competing with npm, yarn, pnpm, and bun. Key differentiator: unlike bundlers that produce readable output (obfuscation or bytecode), AGPK encrypts source code and compiles to native binaries with key splitting and runtime memory-only execution, protecting intellectual property at the binary level.

devops

npm install agpk

package ↗homepage ↗

INSTALL

IMPORT

SIG · AGPK

agpk

devopsjavascriptv1.2.4

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

agpk

✓ import agpk from 'agpk'

✗ const agpk = require('agpk')

Default export for programmatic use. The package is primarily a CLI tool but also exports the core compile and encrypt functions.

AgenticsPackageManager

✓ import { AgenticsPackageManager } from 'agpk'

✗ const { AgenticsPackageManager } = require('agpk')

Named export for the package manager class.

CompileOptions

✓ import type { CompileOptions } from 'agpk'

✗ import { CompileOptions } from 'agpk'

Type-only export, use import type to avoid value import in TypeScript.

Programmatic compile of a JS/TS project to an encrypted native binary using AGPK, demonstrating the default export and compile function.

import agpk from 'agpk'; import path from 'path'; const options = { entry: path.resolve('./src/index.js'), output: './dist/my-app', platform: 'linux-x64', encrypt: true, key: process.env.AGPK_KEY || 'default-key-change-in-production', }; async function build() { try { const result = await agpk.compile(options); console.log('Build successful:', result.binaryPath); } catch (error) { console.error('Build failed:', error); } } build();

Debug

Known issues

breakingAGPK v2 changes the default encryption algorithm from AES-256-CTR to AES-256-GCM. Existing encrypted binaries from v1 are incompatible.

fix

Recompile your project with AGPK v2. Set algorithm: 'aes-256-ctr' in options for backward compatibility if needed.

affects: >=2.0.0

breakingAGPK v2 drops support for Node.js < 18. Ensure your environment uses Node 18+.

fix

Upgrade to Node.js 18 or later.

affects: >=2.0.0

deprecatedThe 'agpk compile' command (with space) is deprecated in favor of 'agpk bundle-compile' in v1.2+

fix

Use 'agpk bundle-compile' instead.

affects: >=1.2.0

gotchaWindows binaries built on Linux using cross-compilation may have compatibility issues with some antivirus software due to the encrypted payload.

fix

Test binaries on target OS. Consider submitting false positive reports to antivirus vendors.

affects: all

gotchaThe encrypted source is only decrypted in memory; debugging with breakpoints inside encrypted code is not possible. Set environment variable AGPK_DEBUG=1 to disable encryption for debug builds.

fix

Use AGPK_DEBUG=1 for development debugging.

affects: all

Errors

Common errors & fixes

Error: Invalid AES key length

User provided a custom key shorter than 32 bytes (256 bits).

fix

Provide a key of exactly 32 bytes (256 bits). For example: const key = crypto.randomBytes(32).toString('hex');

Error: No entry point found

Missing 'main' or 'bin' in package.json and no entry file specified.

fix

Add 'main' to package.json or pass 'entry' option explicitly.

TypeError: agpk.compile is not a function

Using CommonJS require with default export (agpk.default undefined).

fix

Use ESM import or use const agpk = require('agpk').default;

Upgrade

Version history

1.2.4latest on npm

Audit

Dependencies

esbuildrequiredUsed as the default bundler for Stage 1 (bundle) in the compilation pipeline.

Agent activity

44 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

packageagpk ↗

homepagehttps://gitlab.com/agentics-ai/agpk ↗