Reverse engineer anything with agents, from app behavior down to native binaries.
TypeScript agent-skillsai-agentsbinary-analysisclaude-codeclicodexcordisdecompilerdeveloper-toolsdshdsh-pluginghidrahopperllmmcpmodel-context-protocolreareverse-engineeringstatic-analysistouhou
import { ok, err, type Result } from "../domain/result.js";
import type {
ArtifactEntry,
ArtifactTraversalOmission,
} from "../artifacts/ArtifactReader.js";
import { DirectoryArtifactTraversalLimit } from "../artifacts/DirectoryArtifactReader.js";
import { assertArtifactReadActive } from "../artifacts/ArtifactFileOperation.js";
import { classifyAndroidStringsTable } from "../domain/apktool/apktoolResourceAnalysis.js";
import type { ApktoolWorkspace } from "./ApktoolWorkspace.js";
type TableEntryKind = ArtifactEntry["kind"] | ArtifactTraversalOmission["kind"];
interface StringsTableOmission {
readonly path: string;
readonly kind: Exclude<TableEntryKind, "file">;
}
interface DecodedInventory {
count: number;
capped: boolean;
locales: readonly string[];
otherStringsTables: readonly string[];
unreadableStringsTables: readonly StringsTableOmission[];
}
/** Count files over bounded examined coverage, including omitted special entries. */
export const countDecodedFiles = async (
workspace: ApktoolWorkspace,
root: string,
signal: AbortSignal | undefined,
maximumEntries: number,
): Promise<
Result<
DecodedInventory,
{ readonly cause: unknown; readonly partial: DecodedInventory }
>
> => {
let count = 0;
let capped = false;
const locales: string[] = [];
const otherStringsTables: string[] = [];
const unreadableStringsTables: StringsTableOmission[] = [];
const observeTable = (path: string, kind: TableEntryKind): void => {
const match = /^res\/(values(?:-([^/]*))?)\/strings\.xml$/u.exec(path);
if (match === null) return;
if (kind !== "file") {
unreadableStringsTables.push({ path, kind });
return;
}
const suffix = match[2];
if (suffix === undefined) return;
const table = classifyAndroidStringsTable(suffix);
if (table.kind === "locale") locales.push(table.locale);
else otherStringsTables.push(match[1]!);
};
const observation = (): DecodedInventory => {
return {
count,
capped,
locales: locales.sort(),
otherStringsTables: otherStringsTables.sort(),
unreadableStringsTables: unreadableStringsTables.sort((a, b) =>
a.path < b.path ? -1 : a.path > b.path ? 1 : 0,
),
};
};
try {
for await (const entry of workspace.entries(
root,
signal,
maximumEntries,
(omission) => observeTable(omission.path, omission.kind),
)) {
assertArtifactReadActive(signal);
observeTable(entry.path, entry.kind);
if (entry.kind === "file") count += 1;
}
} catch (cause) {
if (!(cause instanceof DirectoryArtifactTraversalLimit))
return err({ cause, partial: observation() });
capped = true;
}
return ok(observation());
};